SslStream Konstruktoren

Referenz

Definition

Namespace:: System.Net.Security

Assembly:: System.Net.Security.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Initialisiert eine neue Instanz der SslStream-Klasse.

Überlädt

SslStream(Stream)	Initialisiert eine neue Instanz der SslStream-Klasse mit dem angegebenen Stream.
SslStream(Stream, Boolean)	Verwendet den angegebenen SslStream und das Schlussverhalten des Streams zum Initialisieren einer neuen Instanz der Stream-Klasse.
SslStream(Stream, Boolean, RemoteCertificateValidationCallback)	Verwendet den angegebenen SslStream, das angegebene Schlussverhalten des Streams und den angegebenen Zertifikatsvalidierungsdelegaten zum Initialisieren einer neuen Instanz der Stream-Klasse.
SslStream(Stream, Boolean, RemoteCertificateValidationCallback, LocalCertificateSelectionCallback)	Verwendet den angegebenen SslStream, das Schlussverhalten des Streams, den Zertifikatsvalidierungsdelegaten und den Zertifikatsauswahldelegaten zum Initialisieren einer neuen Instanz der Stream-Klasse.
SslStream(Stream, Boolean, RemoteCertificateValidationCallback, LocalCertificateSelectionCallback, EncryptionPolicy)	Initialisiert eine neue Instanz der SslStream-Klasse mit dem angegebenen Stream.

Hinweise

Verwenden Sie den Konstruktor SslStream, um zu verhindern, dass der von Ihnen bereitgestellte Stream durch SslStream geschlossen wird.

SslStream(Stream)

Quelle:: SslStream.cs

Quelle:: SslStream.cs

Quelle:: SslStream.cs

Initialisiert eine neue Instanz der SslStream-Klasse mit dem angegebenen Stream.

public:
 SslStream(System::IO::Stream ^ innerStream);

public SslStream (System.IO.Stream innerStream);

new System.Net.Security.SslStream : System.IO.Stream -> System.Net.Security.SslStream

Public Sub New (innerStream As Stream)

Parameter

innerStream: Stream

Ein Stream-Objekt, das von SslStream zum Senden und Empfangen von Daten verwendet wird.

Ausnahmen

ArgumentException

innerStream kann nicht gelesen werden.

- oder -

innerStream kann nicht geschrieben werden.

ArgumentNullException

innerStream ist null.

- oder -

innerStream ist gleich Null.

Hinweise

Wenn in der Konfigurationsdatei für encryptionpolicy kein Wert angegeben wird, wird standardmäßig EncryptionPolicy EncryptionPolicy.RequireEncryption für die SslStream instance festgelegt, die erstellt wird.

Die Verwendung der Null-Verschlüsselung ist erforderlich, wenn die Verschlüsselungsrichtlinie auf EncryptionPolicy.NoEncryptionfestgelegt ist.

Gilt für:

SslStream(Stream, Boolean)

Quelle:: SslStream.cs

Quelle:: SslStream.cs

Quelle:: SslStream.cs

Verwendet den angegebenen SslStream und das Schlussverhalten des Streams zum Initialisieren einer neuen Instanz der Stream-Klasse.

public:
 SslStream(System::IO::Stream ^ innerStream, bool leaveInnerStreamOpen);

public SslStream (System.IO.Stream innerStream, bool leaveInnerStreamOpen);

new System.Net.Security.SslStream : System.IO.Stream * bool -> System.Net.Security.SslStream

Public Sub New (innerStream As Stream, leaveInnerStreamOpen As Boolean)

Parameter

innerStream: Stream

Ein Stream-Objekt, das von SslStream zum Senden und Empfangen von Daten verwendet wird.

leaveInnerStreamOpen: Boolean

Ein boolescher Wert, der das Schließverhalten des Stream-Objekts angibt, das vom SslStream zum Senden und Empfangen von Daten verwendet wird. Dieser Parameter gibt an, ob der innere Datenstrom geöffnet gelassen wird.

Ausnahmen

ArgumentException

innerStream kann nicht gelesen werden.

- oder -

innerStream kann nicht geschrieben werden.

ArgumentNullException

innerStream ist null.

- oder -

innerStream ist gleich Null.

Beispiele

Im folgenden Codebeispiel wird das Aufrufen dieses Konstruktors veranschaulicht.

static void ProcessClient( TcpClient^ client )
{
   
   // A client has connected. Create the 
   // SslStream using the client's network stream.
   SslStream^ sslStream = gcnew SslStream( client->GetStream(),false );
   
   // Authenticate the server but don't require the client to authenticate.
   try
   {
      sslStream->AuthenticateAsServer( serverCertificate, false, true );
      // false == no client cert required; true == check cert revocation.
      
      // Display the properties and settings for the authenticated stream.
      DisplaySecurityLevel( sslStream );
      DisplaySecurityServices( sslStream );
      DisplayCertificateInformation( sslStream );
      DisplayStreamProperties( sslStream );
      
      // Set timeouts for the read and write to 5 seconds.
      sslStream->ReadTimeout = 5000;
      sslStream->WriteTimeout = 5000;
      
      // Read a message from the client.   
      Console::WriteLine( L"Waiting for client message..." );
      String^ messageData = ReadMessage( sslStream );
      Console::WriteLine( L"Received: {0}", messageData );
      
      // Write a message to the client.
      array<Byte>^message = Encoding::UTF8->GetBytes( L"Hello from the server.<EOF>" );
      Console::WriteLine( L"Sending hello message." );
      sslStream->Write( message );
   }
   catch ( AuthenticationException^ e ) 
   {
      Console::WriteLine( L"Exception: {0}", e->Message );
      if ( e->InnerException != nullptr )
      {
         Console::WriteLine( L"Inner exception: {0}", e->InnerException->Message );
      }
      Console::WriteLine( L"Authentication failed - closing the connection." );
      sslStream->Close();
      client->Close();
      return;
   }
   finally
   {
      
      // The client stream will be closed with the sslStream
      // because we specified this behavior when creating
      // the sslStream.
      sslStream->Close();
      client->Close();
   }

}

static void ProcessClient (TcpClient client)
{
    // A client has connected. Create the
    // SslStream using the client's network stream.
    SslStream sslStream = new SslStream(
        client.GetStream(), false);
    // Authenticate the server but don't require the client to authenticate.
    try
    {
        sslStream.AuthenticateAsServer(serverCertificate, clientCertificateRequired: false, checkCertificateRevocation: true);

        // Display the properties and settings for the authenticated stream.
        DisplaySecurityLevel(sslStream);
        DisplaySecurityServices(sslStream);
        DisplayCertificateInformation(sslStream);
        DisplayStreamProperties(sslStream);

        // Set timeouts for the read and write to 5 seconds.
        sslStream.ReadTimeout = 5000;
        sslStream.WriteTimeout = 5000;
        // Read a message from the client.
        Console.WriteLine("Waiting for client message...");
        string messageData = ReadMessage(sslStream);
        Console.WriteLine("Received: {0}", messageData);

        // Write a message to the client.
        byte[] message = Encoding.UTF8.GetBytes("Hello from the server.<EOF>");
        Console.WriteLine("Sending hello message.");
        sslStream.Write(message);
    }
    catch (AuthenticationException e)
    {
        Console.WriteLine("Exception: {0}", e.Message);
        if (e.InnerException != null)
        {
            Console.WriteLine("Inner exception: {0}", e.InnerException.Message);
        }
        Console.WriteLine ("Authentication failed - closing the connection.");
        sslStream.Close();
        client.Close();
        return;
    }
    finally
    {
        // The client stream will be closed with the sslStream
        // because we specified this behavior when creating
        // the sslStream.
        sslStream.Close();
        client.Close();
    }
}

Private Shared Sub ProcessClient(client As TcpClient)
    ' A client has connected. Create the 
    ' SslStream using the client's network stream.
    Dim sslStream = New SslStream(client.GetStream(), False)

    Try

        sslStream.AuthenticateAsServer(serverCertificate, clientCertificateRequired:=False, checkCertificateRevocation:=True)
        ' Display the properties And settings for the authenticated stream.
        DisplaySecurityLevel(sslStream)
        DisplaySecurityServices(sslStream)
        DisplayCertificateInformation(sslStream)
        DisplayStreamProperties(sslStream)

        ' Set timeouts for the read and write to 5 seconds.
        sslStream.ReadTimeout = 5000
        sslStream.WriteTimeout = 5000

        ' Read a message from the client.   
        Console.WriteLine("Waiting for client message...")
        Dim messageData As String = ReadMessage(sslStream)
        Console.WriteLine("Received: {0}", messageData)

        ' Write a message to the client.
        Dim message As Byte() = Encoding.UTF8.GetBytes("Hello from the server.<EOF>")
        Console.WriteLine("Sending hello message.")
        sslStream.Write(message)
    Catch e As AuthenticationException
        Console.WriteLine("Exception: {0}", e.Message)

        If e.InnerException IsNot Nothing Then
            Console.WriteLine("Inner exception: {0}", e.InnerException.Message)
        End If

        Console.WriteLine("Authentication failed - closing the connection.")
        sslStream.Close()
        client.Close()
        Return
    Finally
        ' The client stream will be closed with the sslStream
        ' because we specified this behavior when creating
        ' the sslStream.
        sslStream.Close()
        client.Close()
    End Try
End Sub

Hinweise

Wenn Sie für den Parameter angebentrue, hat das Schließen von SslStream keine Auswirkungen auf den innerStream Stream. Sie müssen explizit schließeninnerStream, wenn Sie ihn nicht mehr leaveStreamOpen benötigen.

Die Verwendung der Null-Verschlüsselung ist erforderlich, wenn die Verschlüsselungsrichtlinie auf EncryptionPolicy.NoEncryptionfestgelegt ist.

Gilt für:

SslStream(Stream, Boolean, RemoteCertificateValidationCallback)

Quelle:: SslStream.cs

Quelle:: SslStream.cs

Quelle:: SslStream.cs

Verwendet den angegebenen SslStream, das angegebene Schlussverhalten des Streams und den angegebenen Zertifikatsvalidierungsdelegaten zum Initialisieren einer neuen Instanz der Stream-Klasse.

public:
 SslStream(System::IO::Stream ^ innerStream, bool leaveInnerStreamOpen, System::Net::Security::RemoteCertificateValidationCallback ^ userCertificateValidationCallback);

public SslStream (System.IO.Stream innerStream, bool leaveInnerStreamOpen, System.Net.Security.RemoteCertificateValidationCallback? userCertificateValidationCallback);

public SslStream (System.IO.Stream innerStream, bool leaveInnerStreamOpen, System.Net.Security.RemoteCertificateValidationCallback userCertificateValidationCallback);

new System.Net.Security.SslStream : System.IO.Stream * bool * System.Net.Security.RemoteCertificateValidationCallback -> System.Net.Security.SslStream

Public Sub New (innerStream As Stream, leaveInnerStreamOpen As Boolean, userCertificateValidationCallback As RemoteCertificateValidationCallback)

Parameter

innerStream: Stream

Ein Stream-Objekt, das von SslStream zum Senden und Empfangen von Daten verwendet wird.

leaveInnerStreamOpen: Boolean

userCertificateValidationCallback: RemoteCertificateValidationCallback

Ein für die Validierung des von der Remoteseite angegebenen Zertifikats verantwortlicher RemoteCertificateValidationCallback-Delegat.

Ausnahmen

ArgumentException

innerStream kann nicht gelesen werden.

- oder -

innerStream kann nicht geschrieben werden.

ArgumentNullException

innerStream ist null.

- oder -

innerStream ist gleich Null.

Beispiele

Im folgenden Codebeispiel wird ein SslStream erstellt und der Clientteil der Authentifizierung initiiert.

// Create a TCP/IP client socket.
// machineName is the host running the server application.
TcpClient^ client = gcnew TcpClient(machineName, 5000);
Console::WriteLine("Client connected.");
  
// Create an SSL stream that will close 
// the client's stream.
SslStream^ sslStream = gcnew SslStream(
    client->GetStream(), false,
    gcnew RemoteCertificateValidationCallback(ValidateServerCertificate),
    nullptr);
  
// The server name must match the name
// on the server certificate.
try
{
    sslStream->AuthenticateAsClient(serverName);
}
catch (AuthenticationException^ ex) 
{
    Console::WriteLine("Exception: {0}", ex->Message);
    if (ex->InnerException != nullptr)
    {
        Console::WriteLine("Inner exception: {0}", 
            ex->InnerException->Message);
    }

    Console::WriteLine("Authentication failed - "
        "closing the connection.");
    sslStream->Close();
    client->Close();
    return;
}

// Create a TCP/IP client socket.
// machineName is the host running the server application.
TcpClient client = new TcpClient(machineName,5000);
Console.WriteLine("Client connected.");
// Create an SSL stream that will close the client's stream.
SslStream sslStream = new SslStream(
    client.GetStream(),
    false,
    new RemoteCertificateValidationCallback (ValidateServerCertificate),
    null
    );
// The server name must match the name on the server certificate.
try
{
    sslStream.AuthenticateAsClient(serverName);
}
catch (AuthenticationException e)
{
    Console.WriteLine("Exception: {0}", e.Message);
    if (e.InnerException != null)
    {
        Console.WriteLine("Inner exception: {0}", e.InnerException.Message);
    }
    Console.WriteLine ("Authentication failed - closing the connection.");
    client.Close();
    return;
}

' Create a TCP/IP client socket.
' machineName is the host running the server application.
Dim client = New TcpClient(machineName, 5000)
Console.WriteLine("Client connected.")

' Create an SSL stream that will close the client's stream.
Dim sslStream = New SslStream(
    client.GetStream(), False, 
    New RemoteCertificateValidationCallback(AddressOf ValidateServerCertificate), Nothing)

' The server name must match the name on the server certificate.
Try
    sslStream.AuthenticateAsClient(serverName)
Catch e As AuthenticationException
    Console.WriteLine("Exception: {0}", e.Message)

    If e.InnerException IsNot Nothing Then
        Console.WriteLine("Inner exception: {0}", e.InnerException.Message)
    End If

    Console.WriteLine("Authentication failed - closing the connection.")
    client.Close()
    Return
End Try

Hinweise

Das userCertificateValidationCallback Argument des certificateErrors Delegaten enthält alle Windows-Fehlercodes, die vom Kanal Security Support Provider Interface (SSPI) zurückgegeben werden. Der Rückgabewert der methode, die vom Delegat aufgerufen wird, bestimmt, ob die userCertificateValidationCallback Authentifizierung erfolgreich ist.

Das Sicherheitsprotokoll und kryptografische Algorithmen sind bereits ausgewählt, wenn die userCertificateValidationCallback Methode des Delegaten aufgerufen wird. Sie können die Methode verwenden, um zu bestimmen, ob die ausgewählten kryptografischen Algorithmen und Stärken für Ihre Anwendung ausreichen. Andernfalls sollte die -Methode zurückgegeben false werden, um zu verhindern, dass die SslStream erstellt wird.

Die Verwendung der Null-Verschlüsselung ist erforderlich, wenn die Verschlüsselungsrichtlinie auf EncryptionPolicy.NoEncryptionfestgelegt ist.

Hinweis

.NET speichert SSL-Sitzungen während der Erstellung zwischen und versucht, nach Möglichkeit eine zwischengespeicherte Sitzung für nachfolgende Anforderungen wiederzuverwenden. Beim Versuch, eine SSL-Sitzung wiederzuverwenden, verwendet das Framework das erste Element des während der X509Certificate2Collection Authentifizierung bereitgestellten Elements (sofern vorhanden), oder versucht, eine anonyme Sitzung wiederzuverwenden, wenn die Zertifikatsammlung leer ist.

Hinweis

Clientzertifikate werden im SSL-Protokoll, Version 2, nicht unterstützt.

Gilt für:

SslStream(Stream, Boolean, RemoteCertificateValidationCallback, LocalCertificateSelectionCallback)

Quelle:: SslStream.cs

Quelle:: SslStream.cs

Quelle:: SslStream.cs

Verwendet den angegebenen SslStream, das Schlussverhalten des Streams, den Zertifikatsvalidierungsdelegaten und den Zertifikatsauswahldelegaten zum Initialisieren einer neuen Instanz der Stream-Klasse.

public:
 SslStream(System::IO::Stream ^ innerStream, bool leaveInnerStreamOpen, System::Net::Security::RemoteCertificateValidationCallback ^ userCertificateValidationCallback, System::Net::Security::LocalCertificateSelectionCallback ^ userCertificateSelectionCallback);

public SslStream (System.IO.Stream innerStream, bool leaveInnerStreamOpen, System.Net.Security.RemoteCertificateValidationCallback? userCertificateValidationCallback, System.Net.Security.LocalCertificateSelectionCallback? userCertificateSelectionCallback);

public SslStream (System.IO.Stream innerStream, bool leaveInnerStreamOpen, System.Net.Security.RemoteCertificateValidationCallback userCertificateValidationCallback, System.Net.Security.LocalCertificateSelectionCallback userCertificateSelectionCallback);

new System.Net.Security.SslStream : System.IO.Stream * bool * System.Net.Security.RemoteCertificateValidationCallback * System.Net.Security.LocalCertificateSelectionCallback -> System.Net.Security.SslStream

Public Sub New (innerStream As Stream, leaveInnerStreamOpen As Boolean, userCertificateValidationCallback As RemoteCertificateValidationCallback, userCertificateSelectionCallback As LocalCertificateSelectionCallback)

Parameter

innerStream: Stream

Ein Stream-Objekt, das von SslStream zum Senden und Empfangen von Daten verwendet wird.

leaveInnerStreamOpen: Boolean

userCertificateValidationCallback: RemoteCertificateValidationCallback

Ein für die Validierung des von der Remoteseite angegebenen Zertifikats verantwortlicher RemoteCertificateValidationCallback-Delegat.

userCertificateSelectionCallback: LocalCertificateSelectionCallback

Ein für die Auswahl des Zertifikats zur Authentifizierung verantwortlicher LocalCertificateSelectionCallback-Delegat.

Ausnahmen

ArgumentException

innerStream kann nicht gelesen werden.

- oder -

innerStream kann nicht geschrieben werden.

ArgumentNullException

innerStream ist null.

- oder -

innerStream ist gleich Null.

Beispiele

Im folgenden Codebeispiel wird das Aufrufen dieses Konstruktors veranschaulicht. Dieses Beispiel ist Teil eines größeren Beispiels, das für die SslStream -Klasse bereitgestellt wird.

// Server name must match the host name and the name on the host's certificate. 
serverName = args[ 1 ];

// Create a TCP/IP client socket.
TcpClient^ client = gcnew TcpClient( serverName,5000 );
Console::WriteLine( L"Client connected." );

// Create an SSL stream that will close the client's stream.
SslStream^ sslStream = gcnew SslStream( 
    client->GetStream(),
    false,
    gcnew RemoteCertificateValidationCallback( ValidateServerCertificate ),
    gcnew LocalCertificateSelectionCallback( SelectLocalCertificate ) );

// Server name must match the host name and the name on the host's certificate.
serverName = args[0];
// Create a TCP/IP client socket.
TcpClient client = new TcpClient(serverName,5000);
Console.WriteLine("Client connected.");
// Create an SSL stream that will close the client's stream.
SslStream sslStream = new SslStream(
    client.GetStream(),
    false,
    new RemoteCertificateValidationCallback (ValidateServerCertificate),
    new LocalCertificateSelectionCallback(SelectLocalCertificate)
    );

' Server name must match the host name and the name on the host's certificate. 
serverName = args(0)
' Create a TCP/IP client socket.
Dim client As New TcpClient(serverName, 5000)
Console.WriteLine("Client connected.")
' Create an SSL stream that will close the client's stream.
Dim sslStream As New SslStream(
    client.GetStream(), False, 
    New RemoteCertificateValidationCallback(AddressOf ValidateServerCertificate), 
    New LocalCertificateSelectionCallback(AddressOf SelectLocalCertificate))

Hinweise

Der userCertificateSelectionCallback Delegat ist nützlich, wenn Ihre Anwendung über mehrere Zertifikate verfügt und dynamisch ein Zertifikat auswählen muss. Zertifikate im Speicher "MY" werden an die Methode übergeben, die vom Delegaten aufgerufen wird.

Die Verwendung der Null-Verschlüsselung ist erforderlich, wenn die Verschlüsselungsrichtlinie auf EncryptionPolicy.NoEncryptionfestgelegt ist.

Hinweis

Gilt für:

SslStream(Stream, Boolean, RemoteCertificateValidationCallback, LocalCertificateSelectionCallback, EncryptionPolicy)

Quelle:: SslStream.IO.cs

Quelle:: SslStream.cs

Quelle:: SslStream.cs

Initialisiert eine neue Instanz der SslStream-Klasse mit dem angegebenen Stream.

public:
 SslStream(System::IO::Stream ^ innerStream, bool leaveInnerStreamOpen, System::Net::Security::RemoteCertificateValidationCallback ^ userCertificateValidationCallback, System::Net::Security::LocalCertificateSelectionCallback ^ userCertificateSelectionCallback, System::Net::Security::EncryptionPolicy encryptionPolicy);

public SslStream (System.IO.Stream innerStream, bool leaveInnerStreamOpen, System.Net.Security.RemoteCertificateValidationCallback? userCertificateValidationCallback, System.Net.Security.LocalCertificateSelectionCallback? userCertificateSelectionCallback, System.Net.Security.EncryptionPolicy encryptionPolicy);

public SslStream (System.IO.Stream innerStream, bool leaveInnerStreamOpen, System.Net.Security.RemoteCertificateValidationCallback userCertificateValidationCallback, System.Net.Security.LocalCertificateSelectionCallback userCertificateSelectionCallback, System.Net.Security.EncryptionPolicy encryptionPolicy);

new System.Net.Security.SslStream : System.IO.Stream * bool * System.Net.Security.RemoteCertificateValidationCallback * System.Net.Security.LocalCertificateSelectionCallback * System.Net.Security.EncryptionPolicy -> System.Net.Security.SslStream

Public Sub New (innerStream As Stream, leaveInnerStreamOpen As Boolean, userCertificateValidationCallback As RemoteCertificateValidationCallback, userCertificateSelectionCallback As LocalCertificateSelectionCallback, encryptionPolicy As EncryptionPolicy)

Parameter

innerStream: Stream

Ein Stream-Objekt, das von SslStream zum Senden und Empfangen von Daten verwendet wird.

leaveInnerStreamOpen: Boolean

userCertificateValidationCallback: RemoteCertificateValidationCallback

Ein für die Validierung des von der Remoteseite angegebenen Zertifikats verantwortlicher RemoteCertificateValidationCallback-Delegat.

userCertificateSelectionCallback: LocalCertificateSelectionCallback

Ein für die Auswahl des Zertifikats zur Authentifizierung verantwortlicher LocalCertificateSelectionCallback-Delegat.

encryptionPolicy: EncryptionPolicy

Der zu verwendende EncryptionPolicy.

Ausnahmen

ArgumentException

innerStream kann nicht gelesen werden.

- oder -

innerStream kann nicht geschrieben werden.

- oder -

encryptionPolicy ist nicht gültig.

ArgumentNullException

innerStream ist null.

- oder -

innerStream ist gleich Null.

Hinweise

Die Verwendung der Null-Verschlüsselung ist erforderlich, wenn der encryptionPolicy Parameter auf EncryptionPolicy.NoEncryptionfestgelegt ist.

Gilt für:

Freigeben über

SslStream Konstruktoren

Definition

Überlädt

Hinweise

SslStream(Stream)

Parameter

Ausnahmen

Hinweise

Gilt für:

SslStream(Stream, Boolean)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

SslStream(Stream, Boolean, RemoteCertificateValidationCallback)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

SslStream(Stream, Boolean, RemoteCertificateValidationCallback, LocalCertificateSelectionCallback)

Parameter

Ausnahmen

Beispiele

Hinweise

Gilt für:

SslStream(Stream, Boolean, RemoteCertificateValidationCallback, LocalCertificateSelectionCallback, EncryptionPolicy)

Parameter

Ausnahmen

Hinweise

Gilt für:

Zusätzliche Ressourcen