1 <?xml version="1.0" encoding="utf-8"?><doc>
3 <name>System.Net.NameResolution</name>
6 <member name="T:System.Net.IPHostEntry">
7 <summary>Provides a container class for Internet host address information.</summary>
9 <member name="M:System.Net.IPHostEntry.#ctor">
10 <summary>Initializes a new instance of the <see cref="T:System.Net.IPHostEntry"></see> class.</summary>
12 <member name="P:System.Net.IPHostEntry.AddressList">
13 <summary>Gets or sets a list of IP addresses that are associated with a host.</summary>
14 <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>
16 <member name="P:System.Net.IPHostEntry.Aliases">
17 <summary>Gets or sets a list of aliases that are associated with a host.</summary>
18 <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>
20 <member name="P:System.Net.IPHostEntry.HostName">
21 <summary>Gets or sets the DNS name of the host.</summary>
22 <returns>A string that contains the primary host name for the server.</returns>
24 <member name="T:System.Net.Dns">
25 <summary>Provides simple domain name resolution functionality.</summary>
27 <member name="M:System.Net.Dns.BeginGetHostAddresses(System.String,System.AsyncCallback,System.Object)">
28 <summary>Asynchronously returns the Internet Protocol (IP) addresses for the specified host.</summary>
29 <param name="hostNameOrAddress">The host name or IP address to resolve.</param>
30 <param name="requestCallback">An <see cref="T:System.AsyncCallback"></see> delegate that references the method to invoke when the operation is complete.</param>
31 <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>
32 <returns>An <see cref="T:System.IAsyncResult"></see> instance that references the asynchronous request.</returns>
33 <exception cref="T:System.ArgumentNullException"><paramref name="hostNameOrAddress">hostNameOrAddress</paramref> is <see langword="null"></see>.</exception>
34 <exception cref="T:System.ArgumentOutOfRangeException">The length of <paramref name="hostNameOrAddress">hostNameOrAddress</paramref> is greater than 255 characters.</exception>
35 <exception cref="T:System.Net.Sockets.SocketException">An error is encountered when resolving <paramref name="hostNameOrAddress">hostNameOrAddress</paramref>.</exception>
36 <exception cref="T:System.ArgumentException"><paramref name="hostNameOrAddress">hostNameOrAddress</paramref> is an invalid IP address.</exception>
38 <member name="M:System.Net.Dns.BeginGetHostByName(System.String,System.AsyncCallback,System.Object)">
39 <summary>Begins an asynchronous request for <see cref="T:System.Net.IPHostEntry"></see> information about the specified DNS host name.</summary>
40 <param name="hostName">The DNS name of the host.</param>
41 <param name="requestCallback">An <see cref="T:System.AsyncCallback"></see> delegate that references the method to invoke when the operation is complete.</param>
42 <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>
43 <returns>An <see cref="T:System.IAsyncResult"></see> instance that references the asynchronous request.</returns>
44 <exception cref="T:System.ArgumentNullException"><paramref name="hostName">hostName</paramref> is <see langword="null"></see>.</exception>
45 <exception cref="T:System.Net.Sockets.SocketException">An error was encountered executing the DNS query.</exception>
47 <member name="M:System.Net.Dns.BeginGetHostEntry(System.Net.IPAddress,System.AsyncCallback,System.Object)">
48 <summary>Asynchronously resolves an IP address to an <see cref="T:System.Net.IPHostEntry"></see> instance.</summary>
49 <param name="address">The IP address to resolve.</param>
50 <param name="requestCallback">An <see cref="T:System.AsyncCallback"></see> delegate that references the method to invoke when the operation is complete.</param>
51 <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>
52 <returns>An <see cref="T:System.IAsyncResult"></see> instance that references the asynchronous request.</returns>
53 <exception cref="T:System.ArgumentNullException"><paramref name="address">address</paramref> is <see langword="null"></see>.</exception>
54 <exception cref="T:System.Net.Sockets.SocketException">An error is encountered when resolving <paramref name="address">address</paramref>.</exception>
55 <exception cref="T:System.ArgumentException"><paramref name="address">address</paramref> is an invalid IP address.</exception>
57 <member name="M:System.Net.Dns.BeginGetHostEntry(System.String,System.AsyncCallback,System.Object)">
58 <summary>Asynchronously resolves a host name or IP address to an <see cref="T:System.Net.IPHostEntry"></see> instance.</summary>
59 <param name="hostNameOrAddress">The host name or IP address to resolve.</param>
60 <param name="requestCallback">An <see cref="T:System.AsyncCallback"></see> delegate that references the method to invoke when the operation is complete.</param>
61 <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>
62 <returns>An <see cref="T:System.IAsyncResult"></see> instance that references the asynchronous request.</returns>
63 <exception cref="T:System.ArgumentNullException"><paramref name="hostNameOrAddress">hostNameOrAddress</paramref> is <see langword="null"></see>.</exception>
64 <exception cref="T:System.ArgumentOutOfRangeException">The length of <paramref name="hostNameOrAddress">hostNameOrAddress</paramref> is greater than 255 characters.</exception>
65 <exception cref="T:System.Net.Sockets.SocketException">An error is encountered when resolving <paramref name="hostNameOrAddress">hostNameOrAddress</paramref>.</exception>
66 <exception cref="T:System.ArgumentException"><paramref name="hostNameOrAddress">hostNameOrAddress</paramref> is an invalid IP address.</exception>
68 <member name="M:System.Net.Dns.BeginResolve(System.String,System.AsyncCallback,System.Object)">
69 <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>
70 <param name="hostName">The DNS name of the host.</param>
71 <param name="requestCallback">An <see cref="T:System.AsyncCallback"></see> delegate that references the method to invoke when the operation is complete.</param>
72 <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>
73 <returns>An <see cref="T:System.IAsyncResult"></see> instance that references the asynchronous request.</returns>
74 <exception cref="T:System.ArgumentNullException"><paramref name="hostName">hostName</paramref> is <see langword="null"></see>.</exception>
75 <exception cref="T:System.Net.Sockets.SocketException">The caller does not have permission to access DNS information.</exception>
77 <member name="M:System.Net.Dns.EndGetHostAddresses(System.IAsyncResult)">
78 <summary>Ends an asynchronous request for DNS information.</summary>
79 <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>
80 <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>
82 <member name="M:System.Net.Dns.EndGetHostByName(System.IAsyncResult)">
83 <summary>Ends an asynchronous request for DNS information.</summary>
84 <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>
85 <returns>An <see cref="T:System.Net.IPHostEntry"></see> object that contains DNS information about a host.</returns>
86 <exception cref="T:System.ArgumentNullException"><paramref name="asyncResult">asyncResult</paramref> is <see langword="null"></see>.</exception>
88 <member name="M:System.Net.Dns.EndGetHostEntry(System.IAsyncResult)">
89 <summary>Ends an asynchronous request for DNS information.</summary>
90 <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>
91 <returns>An <see cref="T:System.Net.IPHostEntry"></see> instance that contains address information about the host.</returns>
92 <exception cref="T:System.ArgumentNullException"><paramref name="asyncResult">asyncResult</paramref> is <see langword="null"></see>.</exception>
94 <member name="M:System.Net.Dns.EndResolve(System.IAsyncResult)">
95 <summary>Ends an asynchronous request for DNS information.</summary>
96 <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>
97 <returns>An <see cref="T:System.Net.IPHostEntry"></see> object that contains DNS information about a host.</returns>
98 <exception cref="T:System.ArgumentNullException"><paramref name="asyncResult">asyncResult</paramref> is <see langword="null"></see>.</exception>
100 <member name="M:System.Net.Dns.GetHostAddresses(System.String)">
101 <summary>Returns the Internet Protocol (IP) addresses for the specified host.</summary>
102 <param name="hostNameOrAddress">The host name or IP address to resolve.</param>
103 <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>
104 <exception cref="T:System.ArgumentNullException"><paramref name="hostNameOrAddress">hostNameOrAddress</paramref> is <see langword="null"></see>.</exception>
105 <exception cref="T:System.ArgumentOutOfRangeException">The length of <paramref name="hostNameOrAddress">hostNameOrAddress</paramref> is greater than 255 characters.</exception>
106 <exception cref="T:System.Net.Sockets.SocketException">An error is encountered when resolving <paramref name="hostNameOrAddress">hostNameOrAddress</paramref>.</exception>
107 <exception cref="T:System.ArgumentException"><paramref name="hostNameOrAddress">hostNameOrAddress</paramref> is an invalid IP address.</exception>
109 <member name="M:System.Net.Dns.GetHostAddressesAsync(System.String)">
110 <summary>Returns the Internet Protocol (IP) addresses for the specified host as an asynchronous operation.</summary>
111 <param name="hostNameOrAddress">The host name or IP address to resolve.</param>
112 <returns>Returns <see cref="T:System.Threading.Tasks.Task`1"></see>.
113 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 <see langword="null"></see>.</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>.
123 An <see cref="T:System.Net.IPHostEntry"></see> instance.</returns>
124 <exception cref="T:System.ArgumentNullException"><paramref name="address">address</paramref> is <see langword="null"></see>.</exception>
125 <exception cref="T:System.Net.Sockets.SocketException">An error is encountered when resolving <paramref name="address">address</paramref>.</exception>
127 <member name="M:System.Net.Dns.GetHostByAddress(System.String)">
128 <summary>Creates an <see cref="T:System.Net.IPHostEntry"></see> instance from an IP address.</summary>
129 <param name="address">An IP address.</param>
130 <returns>An <see cref="T:System.Net.IPHostEntry"></see> instance.</returns>
131 <exception cref="T:System.ArgumentNullException"><paramref name="address">address</paramref> is <see langword="null"></see>.</exception>
132 <exception cref="T:System.Net.Sockets.SocketException">An error is encountered when resolving <paramref name="address">address</paramref>.</exception>
133 <exception cref="T:System.FormatException"><paramref name="address">address</paramref> is not a valid IP address.</exception>
135 <member name="M:System.Net.Dns.GetHostByName(System.String)">
136 <summary>Gets the DNS information for the specified DNS host name.</summary>
137 <param name="hostName">The DNS name of the host.</param>
138 <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>
139 <exception cref="T:System.ArgumentNullException"><paramref name="hostName">hostName</paramref> is <see langword="null"></see>.</exception>
140 <exception cref="T:System.ArgumentOutOfRangeException">The length of <paramref name="hostName">hostName</paramref> is greater than 255 characters.</exception>
141 <exception cref="T:System.Net.Sockets.SocketException">An error is encountered when resolving <paramref name="hostName">hostName</paramref>.</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"></see> instance.</summary>
145 <param name="address">An IP address.</param>
146 <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>
147 <exception cref="T:System.ArgumentNullException"><paramref name="address">address</paramref> is <see langword="null"></see>.</exception>
148 <exception cref="T:System.Net.Sockets.SocketException">An error is encountered when resolving <paramref name="address">address</paramref>.</exception>
149 <exception cref="T:System.ArgumentException"><paramref name="address">address</paramref> is an invalid IP address.</exception>
151 <member name="M:System.Net.Dns.GetHostEntry(System.String)">
152 <summary>Resolves a host name or IP address to an <see cref="T:System.Net.IPHostEntry"></see> instance.</summary>
153 <param name="hostNameOrAddress">The host name or IP address to resolve.</param>
154 <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>
155 <exception cref="T:System.ArgumentNullException">The <paramref name="hostNameOrAddress">hostNameOrAddress</paramref> parameter is <see langword="null"></see>.</exception>
156 <exception cref="T:System.ArgumentOutOfRangeException">The length of <paramref name="hostNameOrAddress">hostNameOrAddress</paramref> parameter is greater than 255 characters.</exception>
157 <exception cref="T:System.Net.Sockets.SocketException">An error was encountered when resolving the <paramref name="hostNameOrAddress">hostNameOrAddress</paramref> parameter.</exception>
158 <exception cref="T:System.ArgumentException">The <paramref name="hostNameOrAddress">hostNameOrAddress</paramref> parameter is an invalid IP address.</exception>
160 <member name="M:System.Net.Dns.GetHostEntryAsync(System.Net.IPAddress)">
161 <summary>Resolves an IP address to an <see cref="T:System.Net.IPHostEntry"></see> instance as an asynchronous operation.</summary>
162 <param name="address">An IP address.</param>
163 <returns>Returns <see cref="T:System.Threading.Tasks.Task`1"></see>.
164 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>
165 <exception cref="T:System.ArgumentNullException"><paramref name="address">address</paramref> is <see langword="null"></see>.</exception>
166 <exception cref="T:System.Net.Sockets.SocketException">An error is encountered when resolving <paramref name="address">address</paramref>.</exception>
167 <exception cref="T:System.ArgumentException"><paramref name="address">address</paramref> is an invalid IP address.</exception>
169 <member name="M:System.Net.Dns.GetHostEntryAsync(System.String)">
170 <summary>Resolves a host name or IP address to an <see cref="T:System.Net.IPHostEntry"></see> instance as an asynchronous operation.</summary>
171 <param name="hostNameOrAddress">The host name or IP address to resolve.</param>
172 <returns>Returns <see cref="T:System.Threading.Tasks.Task`1"></see>.
173 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>
174 <exception cref="T:System.ArgumentNullException">The <paramref name="hostNameOrAddress">hostNameOrAddress</paramref> parameter is <see langword="null"></see>.</exception>
175 <exception cref="T:System.ArgumentOutOfRangeException">The length of <paramref name="hostNameOrAddress">hostNameOrAddress</paramref> parameter is greater than 255 characters.</exception>
176 <exception cref="T:System.Net.Sockets.SocketException">An error was encountered when resolving the <paramref name="hostNameOrAddress">hostNameOrAddress</paramref> parameter.</exception>
177 <exception cref="T:System.ArgumentException">The <paramref name="hostNameOrAddress">hostNameOrAddress</paramref> parameter is an invalid IP address.</exception>
179 <member name="M:System.Net.Dns.GetHostName">
180 <summary>Gets the host name of the local computer.</summary>
181 <returns>A string that contains the DNS host name of the local computer.</returns>
182 <exception cref="T:System.Net.Sockets.SocketException">An error is encountered when resolving the local host name.</exception>
184 <member name="M:System.Net.Dns.Resolve(System.String)">
185 <summary>Resolves a DNS host name or IP address to an <see cref="T:System.Net.IPHostEntry"></see> instance.</summary>
186 <param name="hostName">A DNS-style host name or IP address.</param>
187 <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>
188 <exception cref="T:System.ArgumentNullException"><paramref name="hostName">hostName</paramref> is <see langword="null"></see>.</exception>
189 <exception cref="T:System.ArgumentOutOfRangeException">The length of <paramref name="hostName">hostName</paramref> is greater than 255 characters.</exception>
190 <exception cref="T:System.Net.Sockets.SocketException">An error is encountered when resolving <paramref name="hostName">hostName</paramref>.</exception>