ContactManager.DeleteContact Methode

  • Referenz

Definition

Namespace:
System.Net.PeerToPeer.Collaboration
Assembly:
System.Net.dll

Entfernt einen PeerContact oder einen PeerName aus dem ContactManager des lokalen Peers.

Überlädt

DeleteContact(PeerContact)

Entfernt den angegebenen PeerContact aus dem ContactManager des lokalen Peers.
DeleteContact(PeerName)

Entfernt den PeerContact, der dem angegebenen PeerName aus dem ContactManager des lokalen Peers zugeordnet ist.

DeleteContact(PeerContact)

Entfernt den angegebenen PeerContact aus dem ContactManager des lokalen Peers.

public:
 void DeleteContact(System::Net::PeerToPeer::Collaboration::PeerContact ^ peerContact);
public void DeleteContact (System.Net.PeerToPeer.Collaboration.PeerContact peerContact);
member this.DeleteContact : System.Net.PeerToPeer.Collaboration.PeerContact -> unit
Public Sub DeleteContact (peerContact As PeerContact)

Parameter

peerContact
PeerContact

Der PeerContact, der aus der ContactManager entfernt werden soll.

Ausnahmen

ArgumentNullException

peerContact ist null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein PeerContact aus dem lokalen ContactManagergelöscht wird:

//Enumerating the contacts and letting the user choose which one to delete.
public static void DeleteContact()
{
    PeerContactCollection pcc = null;
    string contactToDelete = "";

    try
    {
        pcc = EnumContacts();
        if (pcc == null ||
            pcc.Count == 0)
        {
            Console.WriteLine("Contact list is empty -- no such contact exists.");
            return;
        }
        Console.Write("Please enter the nickname of the contact you wish to delete: ");
        contactToDelete = Console.ReadLine();

        foreach (PeerContact pc in pcc)
        {
            if (pc.Nickname.Equals(contactToDelete))
            {
                PeerCollaboration.ContactManager.DeleteContact(pc);
                Console.WriteLine("Contact {0} successfully deleted!", contactToDelete);
                return;
            }
        }
        Console.WriteLine("Contact {0} could not be found in the contact collection.", contactToDelete);
    }
    catch (ArgumentNullException argNullEx)
    {
        Console.WriteLine("The supplied contact is null: {0}", argNullEx.Message);
    }
    catch (ArgumentException argEx)
    {
        Console.WriteLine("The supplied contact \"{0}\" could not be found in the Contact Manager: {1}",
            contactToDelete, argEx.Message);
    }
    catch (PeerToPeerException p2pEx)
    {
        Console.WriteLine("The Peer Collaboration Infrastructure could not delete \"{0}\": {1}",
            contactToDelete, p2pEx.Message);
    }
    catch (Exception ex)
    {
        Console.WriteLine("Unexpected exception when trying to delete a contact : {0}", ex);
    }
    return;
}

Hinweise

Für den Aufruf dieser Methode ist eine PermissionState von Unrestrictederforderlich.

Weitere Informationen

Gilt für:

DeleteContact(PeerName)

Entfernt den PeerContact, der dem angegebenen PeerName aus dem ContactManager des lokalen Peers zugeordnet ist.

public:
 void DeleteContact(System::Net::PeerToPeer::PeerName ^ peerName);
[System.Security.SecurityCritical]
public void DeleteContact (System.Net.PeerToPeer.PeerName peerName);
[<System.Security.SecurityCritical>]
member this.DeleteContact : System.Net.PeerToPeer.PeerName -> unit
Public Sub DeleteContact (peerName As PeerName)

Parameter

peerName
PeerName

Der PeerName, der dem PeerContact zugeordnet ist, der aus dem ContactManager entfernt werden soll.

Attribute
SecurityCriticalAttribute

Ausnahmen

ArgumentException

Der PeerContact, der dem PeerName zugeordnet ist, wurde im Contact Manager nicht gefunden.

ArgumentNullException

peerName ist null.

ObjectDisposedException

Dieses Objekt wurde zuvor von Dispose() aufgerufen und kann nicht für zukünftige Vorgänge verwendet werden.

PeerToPeerException

DeleteContact -Vorgang kann nicht abgeschlossen werden.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein PeerContact aus dem lokalen ContactManagergelöscht wird:

//Enumerating the contacts and letting the user choose which one to delete.
public static void DeleteContact()
{
    PeerContactCollection pcc = null;
    string contactToDelete = "";

    try
    {
        pcc = EnumContacts();
        if (pcc == null ||
            pcc.Count == 0)
        {
            Console.WriteLine("Contact list is empty -- no such contact exists.");
            return;
        }
        Console.Write("Please enter the nickname of the contact you wish to delete: ");
        contactToDelete = Console.ReadLine();

        foreach (PeerContact pc in pcc)
        {
            if (pc.Nickname.Equals(contactToDelete))
            {
                PeerCollaboration.ContactManager.DeleteContact(pc);
                Console.WriteLine("Contact {0} successfully deleted!", contactToDelete);
                return;
            }
        }
        Console.WriteLine("Contact {0} could not be found in the contact collection.", contactToDelete);
    }
    catch (ArgumentNullException argNullEx)
    {
        Console.WriteLine("The supplied contact is null: {0}", argNullEx.Message);
    }
    catch (ArgumentException argEx)
    {
        Console.WriteLine("The supplied contact \"{0}\" could not be found in the Contact Manager: {1}",
            contactToDelete, argEx.Message);
    }
    catch (PeerToPeerException p2pEx)
    {
        Console.WriteLine("The Peer Collaboration Infrastructure could not delete \"{0}\": {1}",
            contactToDelete, p2pEx.Message);
    }
    catch (Exception ex)
    {
        Console.WriteLine("Unexpected exception when trying to delete a contact : {0}", ex);
    }
    return;
}

Hinweise

Für den Aufruf dieser Methode ist eine PermissionState von Unrestrictederforderlich.

Weitere Informationen

Gilt für: