PeerNameRegistration.Start Yöntem

Tanım

Ad Alanı:

System.Net.PeerToPeer

Bütünleştirilmiş Kod:

System.Net.dll

içine kaydeder PeerNameCloud. Belirtilmezse EndPointCollection , özelliği tarafından Port belirtilen bağlantı noktası değeriyle otomatik adres seçimi kullanılır.

public:
 void Start();

[System.Security.SecurityCritical]
public void Start ();

[<System.Security.SecurityCritical>]
member this.Start : unit -> unit

Public Sub Start ()

Öznitelikler

SecurityCriticalAttribute

Özel durumlar

ArgumentNullException

PeerName özelliği null olarak ayarlanmıştır.

ObjectDisposedException

Bu nesnenin üzerinde daha önce Dispose() adlı bir nesne vardı.

PeerToPeerException

• Belirtilen PeerName zaten kayıtlı. Yöntemi Update() bir kaydı güncelleştirmek için kullanılmalıdır.

• Uzak eş belirtilen için PeerName öğesine Authority sahip değil.

• PeerName veya Data belirtilmemiş; en az bir tane sağlanmalıdır.

• İleti veya veri öğeleri geçersiz. UseAutoEndPointSelection Ya da ayarlanmadı ve veri blobu belirtilmemiş veya IPEndPoint belirtilmemiş.

Örnekler

Aşağıdaki kod örneği, belirtilen meta verilerle birlikte bir PeerName oluşturur ve kaydeder.

// Creates a PeerName and registers it along with the metadata specified
// The parameters used to register the name are static types that are set
// from user input (command-line or user dialog).
// These parameters include the following:
//   static String peerName
//   static PeerNameType peerNameType
//   static int portNumber
//   static String comment
//   static Cloud cloudName

public static void CreateAndPublishPeerName()
{
    try{
        // Creates a the PeerName to register using the classifier and type provided
        PeerName peerName = new PeerName(peerNameClassifier, peerNameType);

        // Create a registration object which represents the registration
        // of the PeerName in a Cloud
        PeerNameRegistration peerNameRegistration = new PeerNameRegistration();
        peerNameRegistration.PeerName = peerName;
        peerNameRegistration.Port = portNumber;
        peerNameRegistration.Comment = comment;
        peerNameRegistration.Cloud = cloudName;
        // Since the peerNameRegistration.EndPointCollection is not specified,
        // all (IPv4&IPv6) addresses assigned to the local host will
        // automatically be associated with the peerNameRegistration instance.
        // This behavior can be control using peerNameRegistration.UseAutoEndPointSelection

        //Note: Additional information may be specified on the PeerNameRegistration
        // object, which is not shown in this example.

        // Starting the registration means the name is published for
        // other peers to resolve
        peerNameRegistration.Start();
        Console.WriteLine("Registration of Peer Name: {0} complete.", peerName.ToString(), cloudName);
        Console.WriteLine();

        Console.WriteLine("Press any key to stop the registration and close the program");
        Console.ReadKey();

        // Stopping the registration means the name is no longer published
        peerNameRegistration.Stop();
    } catch(Exception e){
        Console.WriteLine("Error creating and registering the PeerName: {0} \n", e.Message);
        Console.WriteLine(e.StackTrace);
    }
}

Açıklamalar

yöntemi özelliğinde PeerName belirtilen eş adını tüm kaynak adreslerine ve Port oluşturucuda belirtilene kaydeder. Varsayılan bağlantı noktası bu yöntem tarafından yalnızca hiçbir uç nokta belirtilmediğinde kullanılır.

Cloud özelliği isenull, bu yöntem , ve ScopeIdiçin varsayılan değerleri ScopeNamebaşlatan alanını kullanarak Available özelliğinde PeerName belirtilen eş adını kaydeder.

Bir PeerNameRegistration nesne başlatıldıktan sonra, Stop bunu durdurmak için yöntemi kullanılır.

Bir kaydı güncelleştirmek için yönteminin Update kullanılması gerekir.