1 <?xml version="1.0" encoding="utf-8"?>
4 <name>System.Net.NameResolution</name>
7 <member name="T:System.Net.Dns">
8 <summary>Provides simple domain name resolution functionality.</summary>
10 <member name="M:System.Net.Dns.BeginGetHostAddresses(System.String,System.AsyncCallback,System.Object)">
11 <summary>Asynchronously returns the Internet Protocol (IP) addresses for the specified host.</summary>
12 <param name="hostNameOrAddress">The host name or IP address to resolve.</param>
13 <param name="requestCallback">An <see cref="T:System.AsyncCallback" /> delegate that references the method to invoke when the operation is complete.</param>
14 <param name="state">A user-defined object that contains information about the operation. This object is passed to the <paramref name="requestCallback" /> delegate when the operation is complete.</param>
15 <returns>An <see cref="T:System.IAsyncResult" /> instance that references the asynchronous request.</returns>
16 <exception cref="T:System.ArgumentNullException">
17 <paramref name="hostNameOrAddress" /> is <see langword="null" />.</exception>
18 <exception cref="T:System.ArgumentOutOfRangeException">The length of <paramref name="hostNameOrAddress" /> is greater than 255 characters.</exception>
19 <exception cref="T:System.Net.Sockets.SocketException">An error is encountered when resolving <paramref name="hostNameOrAddress" />.</exception>
20 <exception cref="T:System.ArgumentException">
21 <paramref name="hostNameOrAddress" /> is an invalid IP address.</exception>
23 <member name="M:System.Net.Dns.BeginGetHostByName(System.String,System.AsyncCallback,System.Object)">
24 <summary>Begins an asynchronous request for <see cref="T:System.Net.IPHostEntry" /> information about the specified DNS host name.</summary>
25 <param name="hostName">The DNS name of the host.</param>
26 <param name="requestCallback">An <see cref="T:System.AsyncCallback" /> delegate that references the method to invoke when the operation is complete.</param>
27 <param name="stateObject">A user-defined object that contains information about the operation. This object is passed to the <paramref name="requestCallback" /> delegate when the operation is complete.</param>
28 <returns>An <see cref="T:System.IAsyncResult" /> instance that references the asynchronous request.</returns>
29 <exception cref="T:System.ArgumentNullException">
30 <paramref name="hostName" /> is <see langword="null" />.</exception>
31 <exception cref="T:System.Net.Sockets.SocketException">An error was encountered executing the DNS query.</exception>
33 <member name="M:System.Net.Dns.BeginGetHostEntry(System.Net.IPAddress,System.AsyncCallback,System.Object)">
34 <summary>Asynchronously resolves an IP address to an <see cref="T:System.Net.IPHostEntry" /> instance.</summary>
35 <param name="address">The IP address to resolve.</param>
36 <param name="requestCallback">An <see cref="T:System.AsyncCallback" /> delegate that references the method to invoke when the operation is complete.</param>
37 <param name="stateObject">A user-defined object that contains information about the operation. This object is passed to the <paramref name="requestCallback" /> delegate when the operation is complete.</param>
38 <returns>An <see cref="T:System.IAsyncResult" /> instance that references the asynchronous request.</returns>
39 <exception cref="T:System.ArgumentNullException">
40 <paramref name="address" /> is <see langword="null" />.</exception>
41 <exception cref="T:System.Net.Sockets.SocketException">An error is encountered when resolving <paramref name="address" />.</exception>
42 <exception cref="T:System.ArgumentException">
43 <paramref name="address" /> is an invalid IP address.</exception>
45 <member name="M:System.Net.Dns.BeginGetHostEntry(System.String,System.AsyncCallback,System.Object)">
46 <summary>Asynchronously resolves a host name or IP address to an <see cref="T:System.Net.IPHostEntry" /> instance.</summary>
47 <param name="hostNameOrAddress">The host name or IP address to resolve.</param>
48 <param name="requestCallback">An <see cref="T:System.AsyncCallback" /> delegate that references the method to invoke when the operation is complete.</param>
49 <param name="stateObject">A user-defined object that contains information about the operation. This object is passed to the <paramref name="requestCallback" /> delegate when the operation is complete.</param>
50 <returns>An <see cref="T:System.IAsyncResult" /> instance that references the asynchronous request.</returns>
51 <exception cref="T:System.ArgumentNullException">
52 <paramref name="hostNameOrAddress" /> is <see langword="null" />.</exception>
53 <exception cref="T:System.ArgumentOutOfRangeException">The length of <paramref name="hostNameOrAddress" /> is greater than 255 characters.</exception>
54 <exception cref="T:System.Net.Sockets.SocketException">An error is encountered when resolving <paramref name="hostNameOrAddress" />.</exception>
55 <exception cref="T:System.ArgumentException">
56 <paramref name="hostNameOrAddress" /> is an invalid IP address.</exception>
58 <member name="M:System.Net.Dns.BeginResolve(System.String,System.AsyncCallback,System.Object)">
59 <summary>Begins an asynchronous request to resolve a DNS host name or IP address to an <see cref="T:System.Net.IPAddress" /> instance.</summary>
60 <param name="hostName">The DNS name of the host.</param>
61 <param name="requestCallback">An <see cref="T:System.AsyncCallback" /> delegate that references the method to invoke when the operation is complete.</param>
62 <param name="stateObject">A user-defined object that contains information about the operation. This object is passed to the <paramref name="requestCallback" /> delegate when the operation is complete.</param>
63 <returns>An <see cref="T:System.IAsyncResult" /> instance that references the asynchronous request.</returns>
64 <exception cref="T:System.ArgumentNullException">
65 <paramref name="hostName" /> is <see langword="null" />.</exception>
66 <exception cref="T:System.Net.Sockets.SocketException">The caller does not have permission to access DNS information.</exception>
68 <member name="M:System.Net.Dns.EndGetHostAddresses(System.IAsyncResult)">
69 <summary>Ends an asynchronous request for DNS information.</summary>
70 <param name="asyncResult">An <see cref="T:System.IAsyncResult" /> instance returned by a call to the <see cref="M:System.Net.Dns.BeginGetHostAddresses(System.String,System.AsyncCallback,System.Object)" /> method.</param>
71 <returns>An array of type <see cref="T:System.Net.IPAddress" /> that holds the IP addresses for the host specified by the <paramref name="hostNameOrAddress" /> parameter of <see cref="M:System.Net.Dns.BeginGetHostAddresses(System.String,System.AsyncCallback,System.Object)" />.</returns>
73 <member name="M:System.Net.Dns.EndGetHostByName(System.IAsyncResult)">
74 <summary>Ends an asynchronous request for DNS information.</summary>
75 <param name="asyncResult">An <see cref="T:System.IAsyncResult" /> instance that is returned by a call to the <see cref="M:System.Net.Dns.BeginGetHostByName(System.String,System.AsyncCallback,System.Object)" /> method.</param>
76 <returns>An <see cref="T:System.Net.IPHostEntry" /> object that contains DNS information about a host.</returns>
77 <exception cref="T:System.ArgumentNullException">
78 <paramref name="asyncResult" /> is <see langword="null" />.</exception>
80 <member name="M:System.Net.Dns.EndGetHostEntry(System.IAsyncResult)">
81 <summary>Ends an asynchronous request for DNS information.</summary>
82 <param name="asyncResult">An <see cref="T:System.IAsyncResult" /> instance returned by a call to an <see cref="Overload:System.Net.Dns.BeginGetHostEntry" /> method.</param>
83 <returns>An <see cref="T:System.Net.IPHostEntry" /> instance that contains address information about the host.</returns>
84 <exception cref="T:System.ArgumentNullException">
85 <paramref name="asyncResult" /> is <see langword="null" />.</exception>
87 <member name="M:System.Net.Dns.EndResolve(System.IAsyncResult)">
88 <summary>Ends an asynchronous request for DNS information.</summary>
89 <param name="asyncResult">An <see cref="T:System.IAsyncResult" /> instance that is returned by a call to the <see cref="M:System.Net.Dns.BeginResolve(System.String,System.AsyncCallback,System.Object)" /> method.</param>
90 <returns>An <see cref="T:System.Net.IPHostEntry" /> object that contains DNS information about a host.</returns>
91 <exception cref="T:System.ArgumentNullException">
92 <paramref name="asyncResult" /> is <see langword="null" />.</exception>
94 <member name="M:System.Net.Dns.GetHostAddresses(System.String)">
95 <summary>Returns the Internet Protocol (IP) addresses for the specified host.</summary>
96 <param name="hostNameOrAddress">The host name or IP address to resolve.</param>
97 <returns>An array of type <see cref="T:System.Net.IPAddress" /> that holds the IP addresses for the host that is specified by the <paramref name="hostNameOrAddress" /> parameter.</returns>
98 <exception cref="T:System.ArgumentNullException">
99 <paramref name="hostNameOrAddress" /> is <see langword="null" />.</exception>
100 <exception cref="T:System.ArgumentOutOfRangeException">The length of <paramref name="hostNameOrAddress" /> is greater than 255 characters.</exception>
101 <exception cref="T:System.Net.Sockets.SocketException">An error is encountered when resolving <paramref name="hostNameOrAddress" />.</exception>
102 <exception cref="T:System.ArgumentException">
103 <paramref name="hostNameOrAddress" /> is an invalid IP address.</exception>
105 <member name="M:System.Net.Dns.GetHostAddressesAsync(System.String)">
106 <summary>Returns the Internet Protocol (IP) addresses for the specified host as an asynchronous operation.</summary>
107 <param name="hostNameOrAddress">The host name or IP address to resolve.</param>
108 <returns>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns an array of type <see cref="T:System.Net.IPAddress" /> that holds the IP addresses for the host that is specified by the <paramref name="hostNameOrAddress" /> parameter.</returns>
109 <exception cref="T:System.ArgumentNullException">
110 <paramref name="hostNameOrAddress" /> is <see langword="null" />.</exception>
111 <exception cref="T:System.ArgumentOutOfRangeException">The length of <paramref name="hostNameOrAddress" /> is greater than 255 characters.</exception>
112 <exception cref="T:System.Net.Sockets.SocketException">An error is encountered when resolving <paramref name="hostNameOrAddress" />.</exception>
113 <exception cref="T:System.ArgumentException">
114 <paramref name="hostNameOrAddress" /> is an invalid IP address.</exception>
116 <member name="M:System.Net.Dns.GetHostByAddress(System.Net.IPAddress)">
117 <summary>Creates an <see cref="T:System.Net.IPHostEntry" /> instance from the specified <see cref="T:System.Net.IPAddress" />.</summary>
118 <param name="address">An <see cref="T:System.Net.IPAddress" />.</param>
119 <returns>An <see cref="T:System.Net.IPHostEntry" /> instance.</returns>
120 <exception cref="T:System.ArgumentNullException">
121 <paramref name="address" /> is <see langword="null" />.</exception>
122 <exception cref="T:System.Net.Sockets.SocketException">An error is encountered when resolving <paramref name="address" />.</exception>
124 <member name="M:System.Net.Dns.GetHostByAddress(System.String)">
125 <summary>Creates an <see cref="T:System.Net.IPHostEntry" /> instance from an IP address.</summary>
126 <param name="address">An IP address.</param>
127 <returns>An <see cref="T:System.Net.IPHostEntry" /> instance.</returns>
128 <exception cref="T:System.ArgumentNullException">
129 <paramref name="address" /> is <see langword="null" />.</exception>
130 <exception cref="T:System.Net.Sockets.SocketException">An error is encountered when resolving <paramref name="address" />.</exception>
131 <exception cref="T:System.FormatException">
132 <paramref name="address" /> is not a valid IP address.</exception>
134 <member name="M:System.Net.Dns.GetHostByName(System.String)">
135 <summary>Gets the DNS information for the specified DNS host name.</summary>
136 <param name="hostName">The DNS name of the host.</param>
137 <returns>An <see cref="T:System.Net.IPHostEntry" /> object that contains host information for the address specified in <paramref name="hostName" />.</returns>
138 <exception cref="T:System.ArgumentNullException">
139 <paramref name="hostName" /> is <see langword="null" />.</exception>
140 <exception cref="T:System.ArgumentOutOfRangeException">The length of <paramref name="hostName" /> is greater than 255 characters.</exception>
141 <exception cref="T:System.Net.Sockets.SocketException">An error is encountered when resolving <paramref name="hostName" />.</exception>
143 <member name="M:System.Net.Dns.GetHostEntry(System.Net.IPAddress)">
144 <summary>Resolves an IP address to an <see cref="T:System.Net.IPHostEntry" /> instance.</summary>
145 <param name="address">An IP address.</param>
146 <returns>An <see cref="T:System.Net.IPHostEntry" /> instance that contains address information about the host specified in <paramref name="address" />.</returns>
147 <exception cref="T:System.ArgumentNullException">
148 <paramref name="address" /> is <see langword="null" />.</exception>
149 <exception cref="T:System.Net.Sockets.SocketException">An error is encountered when resolving <paramref name="address" />.</exception>
150 <exception cref="T:System.ArgumentException">
151 <paramref name="address" /> is an invalid IP address.</exception>
153 <member name="M:System.Net.Dns.GetHostEntry(System.String)">
154 <summary>Resolves a host name or IP address to an <see cref="T:System.Net.IPHostEntry" /> instance.</summary>
155 <param name="hostNameOrAddress">The host name or IP address to resolve.</param>
156 <returns>An <see cref="T:System.Net.IPHostEntry" /> instance that contains address information about the host specified in <paramref name="hostNameOrAddress" />.</returns>
157 <exception cref="T:System.ArgumentNullException">The <paramref name="hostNameOrAddress" /> parameter is <see langword="null" />.</exception>
158 <exception cref="T:System.ArgumentOutOfRangeException">The length of <paramref name="hostNameOrAddress" /> parameter is greater than 255 characters.</exception>
159 <exception cref="T:System.Net.Sockets.SocketException">An error was encountered when resolving the <paramref name="hostNameOrAddress" /> parameter.</exception>
160 <exception cref="T:System.ArgumentException">The <paramref name="hostNameOrAddress" /> parameter is an invalid IP address.</exception>
162 <member name="M:System.Net.Dns.GetHostEntryAsync(System.Net.IPAddress)">
163 <summary>Resolves an IP address to an <see cref="T:System.Net.IPHostEntry" /> instance as an asynchronous operation.</summary>
164 <param name="address">An IP address.</param>
165 <returns>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns an <see cref="T:System.Net.IPHostEntry" /> instance that contains address information about the host specified in <paramref name="address" />.</returns>
166 <exception cref="T:System.ArgumentNullException">
167 <paramref name="address" /> is <see langword="null" />.</exception>
168 <exception cref="T:System.Net.Sockets.SocketException">An error is encountered when resolving <paramref name="address" />.</exception>
169 <exception cref="T:System.ArgumentException">
170 <paramref name="address" /> is an invalid IP address.</exception>
172 <member name="M:System.Net.Dns.GetHostEntryAsync(System.String)">
173 <summary>Resolves a host name or IP address to an <see cref="T:System.Net.IPHostEntry" /> instance as an asynchronous operation.</summary>
174 <param name="hostNameOrAddress">The host name or IP address to resolve.</param>
175 <returns>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns an <see cref="T:System.Net.IPHostEntry" /> instance that contains address information about the host specified in <paramref name="hostNameOrAddress" />.</returns>
176 <exception cref="T:System.ArgumentNullException">The <paramref name="hostNameOrAddress" /> parameter is <see langword="null" />.</exception>
177 <exception cref="T:System.ArgumentOutOfRangeException">The length of <paramref name="hostNameOrAddress" /> parameter is greater than 255 characters.</exception>
178 <exception cref="T:System.Net.Sockets.SocketException">An error was encountered when resolving the <paramref name="hostNameOrAddress" /> parameter.</exception>
179 <exception cref="T:System.ArgumentException">The <paramref name="hostNameOrAddress" /> parameter is an invalid IP address.</exception>
181 <member name="M:System.Net.Dns.GetHostName">
182 <summary>Gets the host name of the local computer.</summary>
183 <returns>A string that contains the DNS host name of the local computer.</returns>
184 <exception cref="T:System.Net.Sockets.SocketException">An error is encountered when resolving the local host name.</exception>
186 <member name="M:System.Net.Dns.Resolve(System.String)">
187 <summary>Resolves a DNS host name or IP address to an <see cref="T:System.Net.IPHostEntry" /> instance.</summary>
188 <param name="hostName">A DNS-style host name or IP address.</param>
189 <returns>An <see cref="T:System.Net.IPHostEntry" /> instance that contains address information about the host specified in <paramref name="hostName" />.</returns>
190 <exception cref="T:System.ArgumentNullException">
191 <paramref name="hostName" /> is <see langword="null" />.</exception>
192 <exception cref="T:System.ArgumentOutOfRangeException">The length of <paramref name="hostName" /> is greater than 255 characters.</exception>
193 <exception cref="T:System.Net.Sockets.SocketException">An error is encountered when resolving <paramref name="hostName" />.</exception>
195 <member name="T:System.Net.IPHostEntry">
196 <summary>Provides a container class for Internet host address information.</summary>
198 <member name="M:System.Net.IPHostEntry.#ctor">
199 <summary>Initializes a new instance of the <see cref="T:System.Net.IPHostEntry" /> class.</summary>
201 <member name="P:System.Net.IPHostEntry.AddressList">
202 <summary>Gets or sets a list of IP addresses that are associated with a host.</summary>
203 <returns>An array of type <see cref="T:System.Net.IPAddress" /> that contains IP addresses that resolve to the host names that are contained in the <see cref="P:System.Net.IPHostEntry.Aliases" /> property.</returns>
205 <member name="P:System.Net.IPHostEntry.Aliases">
206 <summary>Gets or sets a list of aliases that are associated with a host.</summary>
207 <returns>An array of strings that contain DNS names that resolve to the IP addresses in the <see cref="P:System.Net.IPHostEntry.AddressList" /> property.</returns>
209 <member name="P:System.Net.IPHostEntry.HostName">
210 <summary>Gets or sets the DNS name of the host.</summary>
211 <returns>A string that contains the primary host name for the server.</returns>