See Also

Dns Class  | Dns Members

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows ME, Windows 2000, Windows XP, Windows Server 2003, Windows Vista

Language

Visual Basic

C#

C++

C++/CLI

Show All

See Also Languages PowerTCP Email Validation for .NET

Retries Property

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); }

Return Type

An integer representing the number of retries to perform on failed lookups.

Remarks

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.

Example

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);
}
                

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows ME, Windows 2000, Windows XP, Windows Server 2003, Windows Vista

See Also

Dns Class  | Dns Members


Send comments on this topic.

Documentation version 1.0.3.0.

© 2008 Dart Communications.  All rights reserved.