Dart.PowerTCP.EmailValidation Namespace > Dns Class : RotateServers Property |
Gets or Sets a value that controls whether the first item in Servers is the first server tried for all lookups.
[Visual Basic]
<CategoryAttribute("Behavior")>
<DescriptionAttribute("Gets or Sets a value that controls whether the first item in Servers is the first server tried for all lookups.")>
<DefaultValueAttribute()>
Public Property RotateServers As Boolean
[C#]
[CategoryAttribute("Behavior")]
[DescriptionAttribute("Gets or Sets a value that controls whether the first item in Servers is the first server tried for all lookups.")]
[DefaultValueAttribute()]
public bool RotateServers {get; set;}
[C++]
[CategoryAttribute("Behavior")]
[DescriptionAttribute("Gets or Sets a value that controls whether the first item in Servers is the first server tried for all lookups.")]
[DefaultValueAttribute()]
public: __property bool get_RotateServers();
public: __property void set_RotateServers(
bool value
);
[C++/CLI]
[CategoryAttribute("Behavior")]
[DescriptionAttribute("Gets or Sets a value that controls whether the first item in Servers is the first server tried for all lookups.")]
[DefaultValueAttribute()]
public:
property bool RotateServers {
bool get();
void set (bool value);
}
A boolean indicating whether or not to always use the first server for new lookups. Defaults to false.
If Dns.Servers has more than one item, the user has the option of either always starting with the first server on new lookups, or using the next server listed.
The following example demonstrates using the Dns control to resolve a domain name.
[Visual Basic]
Private Sub ResolveTest()
Dns1.Servers.Add("206.64.128.5") 'Adds this server to list of DNS servers
Dns1.RotateServers = True 'Will always try next server in Dns1.Servers
Dns1.Retries = 2 'On failures, try an additional two times
Dns1.RetryInterval = 0 'Do not wait between retries
Dim result As System.Net.IPHostEntry = Dns1.GetHost("www.dart.com")
DisplayResult(result)
End Sub
Private Sub DisplayResult(ByVal result As System.Net.IPHostEntry)
' Display host name
Debug.WriteLine("Host name: " + result.HostName)
' Display addresses, if any
Dim add As System.Net.IPAddress
For Each add In result.AddressList
Debug.WriteLine("Address: " + add.ToString())
Next
' Display aliases, if any
Dim s As String
For Each s In result.Aliases
Debug.WriteLine("Aliases: " + s)
Next
End Sub
[C#]
private void ResolveTest()
{
dns1.Servers.Add("206.64.128.5"); 'Adds this server to list of
DNS servers
dns1.RotateServers = true; 'Will always try next server in Dns1.Servers
dns1.Retries = 2; 'On failures, try an additional two times
dns1.RetryInterval = 0; 'Do not wait between retries
System.Net.IPHostEntry result = dns1.GetHost("www.dart.com");
DisplayResult(result);
}
private void DisplayResult(System.Net.IPHostEntry result)
{
// Display host name
Debug.WriteLine("Host name: " + result.HostName);
// Display addresses, if any
foreach(System.Net.IPAddress add in result.AddressList)
Debug.WriteLine("Address: " + add.ToString());
// Display aliases, if any
foreach(string s in result.Aliases)
Debug.WriteLine("Aliases: " + s);
}
Platforms: Windows 98, Windows NT 4.0, Windows ME, Windows 2000, Windows XP, Windows Server 2003, Windows Vista
Send comments on this topic.
Documentation version 1.0.3.0.
© 2008 Dart Communications. All rights reserved.