AsymmetricAlgorithm.ToXmlString-Methode

Artikel
08/20/2007

Erstellt beim Überschreiben in einer abgeleiteten Klasse eine XML-Zeichenfolgendarstellung des aktuellen AsymmetricAlgorithm-Objekts und gibt diese zurück.

Namespace: System.Security.Cryptography
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public MustOverride Function ToXmlString ( _
    includePrivateParameters As Boolean _
) As String
'Usage
Dim instance As AsymmetricAlgorithm
Dim includePrivateParameters As Boolean
Dim returnValue As String

returnValue = instance.ToXmlString(includePrivateParameters)

public abstract string ToXmlString (
    bool includePrivateParameters
)

public:
virtual String^ ToXmlString (
    bool includePrivateParameters
) abstract

public abstract String ToXmlString (
    boolean includePrivateParameters
)

public abstract function ToXmlString (
    includePrivateParameters : boolean
) : String

Parameter

includePrivateParameters
true, wenn private Parameter angegeben werden sollen, andernfalls false.

Rückgabewert

Eine XML-Zeichenfolgencodierung des aktuellen AsymmetricAlgorithm-Objekts.

Beispiel

Im folgenden Codebeispiel wird der Aufruf der ToXmlString-Methode zum Erstellen einer XML-Darstellung der Parameter im aktuellen AsymmetricAlgorithm-Objekt veranschaulicht. Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels für die AsymmetricAlgorithm-Klasse.

Public Overrides Function ToXmlString( _
    ByVal includePrivateParameters As Boolean) As String

    Dim keyContainerName As String = ""
    Dim keyNumber As String = ""
    Dim providerName As String = ""
    Dim providerType As String = ""

    If Not cspParameters Is Nothing Then
        keyContainerName = cspParameters.KeyContainerName
        keyNumber = cspParameters.KeyNumber.ToString()
        providerName = cspParameters.ProviderName
        providerType = cspParameters.ProviderType.ToString()
    End If

    Dim xmlBuilder As New StringBuilder
    xmlBuilder.Append("<CustomCryptoKeyValue>")

    xmlBuilder.Append("<KeyContainerName>")
    xmlBuilder.Append(keyContainerName)
    xmlBuilder.Append("</KeyContainerName>")

    xmlBuilder.Append("<KeyNumber>")
    xmlBuilder.Append(keyNumber)
    xmlBuilder.Append("</KeyNumber>")

    xmlBuilder.Append("<ProviderName>")
    xmlBuilder.Append(providerName)
    xmlBuilder.Append("</ProviderName>")

    xmlBuilder.Append("<ProviderType>")
    xmlBuilder.Append(providerType)
    xmlBuilder.Append("</ProviderType>")

    xmlBuilder.Append("</CustomCryptoKeyValue>")
    Return (xmlBuilder.ToString())
End Function

public override string ToXmlString(bool includePrivateParameters)
{
    string keyContainerName = "";
    string keyNumber = "";
    string providerName = "";
    string providerType = "";

    if (cspParameters != null)
    {
        keyContainerName = cspParameters.KeyContainerName;
        keyNumber = cspParameters.KeyNumber.ToString();
        providerName = cspParameters.ProviderName;
        providerType = cspParameters.ProviderType.ToString();
    }

    StringBuilder sb = new StringBuilder();
    sb.Append("<CustomCryptoKeyValue>");

    sb.Append("<KeyContainerName>");
    sb.Append(keyContainerName);
    sb.Append("</KeyContainerName>");

    sb.Append("<KeyNumber>");
    sb.Append(keyNumber);
    sb.Append("</KeyNumber>");

    sb.Append("<ProviderName>");
    sb.Append(providerName);
    sb.Append("</ProviderName>");

    sb.Append("<ProviderType>");
    sb.Append(providerType);
    sb.Append("</ProviderType>");

    sb.Append("</CustomCryptoKeyValue>");
    return(sb.ToString());
}

public:
    virtual String^ ToXmlString(bool includePrivateParameters) override
    {
        String^ keyContainerName = "";
        String^ keyNumber = "";
        String^ providerName = "";
        String^ providerType = "";

        if (cryptoServiceParameters != nullptr)
        {
            keyContainerName = 
                cryptoServiceParameters->KeyContainerName;
            keyNumber = cryptoServiceParameters->KeyNumber.ToString();
            providerName = cryptoServiceParameters->ProviderName;
            providerType = 
                cryptoServiceParameters->ProviderType.ToString();
        }

        StringBuilder^ sb = gcnew StringBuilder();
        sb->Append("<CustomCryptoKeyValue>");

        sb->Append("<KeyContainerName>");
        sb->Append(keyContainerName);
        sb->Append("</KeyContainerName>");

        sb->Append("<KeyNumber>");
        sb->Append(keyNumber);
        sb->Append("</KeyNumber>");

        sb->Append("<ProviderName>");
        sb->Append(providerName);
        sb->Append("</ProviderName>");

        sb->Append("<ProviderType>");
        sb->Append(providerType);
        sb->Append("</ProviderType>");

        sb->Append("</CustomCryptoKeyValue>");
        return(sb->ToString());
    }

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

AsymmetricAlgorithm-Klasse
AsymmetricAlgorithm-Member
System.Security.Cryptography-Namespace

Weitere Ressourcen

Kryptografische Dienste

Freigeben über