ContactManager.DeleteContact 方法

定义

命名空间:

System.Net.PeerToPeer.Collaboration

程序集:

System.Net.dll

从本地对等方的 PeerContact 中移除 PeerName 或 ContactManager。

重载

DeleteContact(PeerContact)	从本地对等的 ContactManager 删除指定的 PeerContact。
DeleteContact(PeerName)	从本地对等的 ContactManager 中删除与指定 PeerName 关联的 PeerContact。

DeleteContact(PeerContact)

从本地对等的 ContactManager 删除指定的 PeerContact。

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)

参数

peerContact

PeerContact

要从 PeerContact 移除的 ContactManager。

例外

ArgumentNullException

peerContact 为 null。

示例

下面的代码示例演示如何从本地 ContactManager中删除 PeerContact 。

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

注解

调用此方法需要 PermissionState 的 Unrestricted。

另请参阅

• GetContact(PeerName)

DeleteContact(PeerName)

从本地对等的 ContactManager 中删除与指定 PeerName 关联的 PeerContact。

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)

参数

peerName

PeerName

要从 ContactManager 中删除的与 PeerContact 关联的 PeerName。

属性

SecurityCriticalAttribute

例外

ArgumentException

无法在联系人管理器中找到与 PeerName 相关联的 PeerContact。

ArgumentNullException

peerName 为 null。

ObjectDisposedException

此对象之前让 Dispose() 对其进行了调用，并且不能用于将来的操作。

PeerToPeerException

无法完成 DeleteContact 操作。

示例

下面的代码示例演示如何从本地 ContactManager中删除 PeerContact 。

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

注解

调用此方法需要 PermissionState 的 Unrestricted。

另请参阅

• PeerNearMe