Dart.PowerTCP.EmailValidation Namespace > Dns Class : Retries Property |
Gets or Sets a value that controls the number of retries on failed lookups. Defaults to 0.
[Visual Basic]
<CategoryAttribute("Behavior")>
<DefaultValueAttribute()>
<DescriptionAttribute("Gets or Sets a value that controls the number of retries on failed lookups.")>
Public Property Retries As Integer
[C#]
[CategoryAttribute("Behavior")]
[DefaultValueAttribute()]
[DescriptionAttribute("Gets or Sets a value that controls the number of retries on failed lookups.")]
public int Retries {get; set;}
[C++]
[CategoryAttribute("Behavior")]
[DefaultValueAttribute()]
[DescriptionAttribute("Gets or Sets a value that controls the number of retries on failed lookups.")]
public: __property int get_Retries();
public: __property void set_Retries(
int value
);
[C++/CLI]
[CategoryAttribute("Behavior")]
[DefaultValueAttribute()]
[DescriptionAttribute("Gets or Sets a value that controls the number of retries on failed lookups.")]
public:
property int Retries {
int get();
void set (int value);
}
An integer representing the number of retries to perform on failed lookups.
A lookup will try each server in Dns.Servers. If all servers fail, the component will continue trying in this fashion until success or the Retries value is met.
Set Dns.RetryInterval to insert a delay between retries. This can prevent overloading DNS servers with requests.
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.