PeerNameRegistration.Start Metode

Definisi

Ruang nama:

System.Net.PeerToPeer

Rakitan:

System.Net.dll

Mendaftarkan ke PeerName dalam Cloud. Jika tidak EndPointCollection ditentukan, pemilihan alamat otomatis digunakan dengan nilai port yang ditentukan oleh Port properti .

public:
 void Start();

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

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

Public Sub Start ()

Atribut

SecurityCriticalAttribute

Pengecualian

ArgumentNullException

Properti PeerName diatur ke null.

ObjectDisposedException

Objek ini telah dipanggil Dispose() sebelumnya.

PeerToPeerException

• Yang PeerName ditentukan telah didaftarkan. Metode Update() harus digunakan untuk memperbarui pendaftaran.

• Rekan jarak jauh tidak memiliki Authority untuk yang PeerName ditentukan.

• PeerName Baik atau Data tidak ditentukan; setidaknya satu perlu disediakan.

• Elemen pesan atau data tidak valid. Atau, UseAutoEndPointSelection tidak diatur dan tidak ada blob data atau IPEndPoint yang ditentukan.

Contoh

Contoh kode berikut membuat PeerName dan mendaftarkannya bersama dengan metadata yang ditentukan.

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

Keterangan

Metode mendaftarkan nama serekan yang ditentukan dalam PeerName properti dengan semua alamat sumber dan Port yang ditentukan dalam konstruktor. Port default digunakan oleh metode ini hanya ketika tidak ada titik akhir yang ditentukan.

Cloud Jika properti adalah null, metode ini mendaftarkan nama serekan yang ditentukan dalam PeerName properti menggunakan Available bidang , yang menginisialisasi nilai default untuk Name, , Scopedan ScopeId.

PeerNameRegistration Setelah objek dimulai, Stop metode digunakan untuk menghentikannya.

Untuk memperbarui pendaftaran, Update metode harus digunakan.