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