Freigeben über


ContactManager.DeleteContact Methode

Definition

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

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

Ausnahmen

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

peerName ist null.

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

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: