SslStream.Write Yöntem

Başvuru

Tanım

Ad Alanı:: System.Net.Security

Bütünleştirilmiş Kod:: System.Net.Security.dll

Bütünleştirilmiş Kod:: System.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Bu akışa veri yazar.

Aşırı Yüklemeler

Write(Byte[])	Belirtilen verileri bu akışa yazar.
Write(Byte[], Int32, Int32)	Belirtilen arabellek ve uzaklığı kullanarak temel alınan akışa belirtilen sayıda Bytes yazın.

Write(Byte[])

Belirtilen verileri bu akışa yazar.

public:
 void Write(cli::array <System::Byte> ^ buffer);

public:
 virtual void Write(cli::array <System::Byte> ^ buffer);

public void Write (byte[] buffer);

override this.Write : byte[] -> unit

Public Sub Write (buffer As Byte())

Parametreler

buffer: Byte[]

Byte Akışa yazılan baytları sağlayan bir dizi.

Özel durumlar

ArgumentNullException

buffer, null değeridir.

IOException

Yazma işlemi başarısız oldu.

NotSupportedException

Devam eden bir yazma işlemi zaten var.

ObjectDisposedException

Bu nesne kapatıldı.

InvalidOperationException

Kimlik doğrulaması gerçekleşmedi.

Örnekler

Aşağıdaki kod örneği, kimliği doğrulanmış SslStreambir öğesine yazmayı gösterir.

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

Açıklamalar

bu yöntem, işlem tamamlarken engeller. İşlem tamamlarken engellemeyi önlemek için yöntemini kullanın BeginWrite .

Kimlik doğrulaması başarılı olana kadar bu yöntemi çağıramazsınız. Kimlik doğrulaması yapmak için , veya BeginAuthenticateAsClient, AuthenticateAsServer, BeginAuthenticateAsServer yöntemlerinden birini AuthenticateAsClientçağırın.

sınıfı SslStream birden çok eşzamanlı yazma işlemini desteklemez.

Şunlara uygulanır

Write(Byte[], Int32, Int32)

Belirtilen arabellek ve uzaklığı kullanarak temel alınan akışa belirtilen sayıda Bytes yazın.

public:
 override void Write(cli::array <System::Byte> ^ buffer, int offset, int count);

public override void Write (byte[] buffer, int offset, int count);

override this.Write : byte[] * int * int -> unit

Public Overrides Sub Write (buffer As Byte(), offset As Integer, count As Integer)

Parametreler

buffer: Byte[]

Byte Akışa yazılan baytları sağlayan bir dizi.

offset: Int32

Int32 Akışa yazılacak baytları okumaya başlanacak sıfır tabanlı konumu buffer içeren bir.

count: Int32

Int32'den bufferokunacak bayt sayısını içeren bir.

Özel durumlar

ArgumentNullException

buffer, null değeridir.

ArgumentException

offset, sıfırdan küçüktür.

-veya-

offset uzunluğundan bufferbüyük.

-veya- offset + sayı, uzunluğundan bufferbüyüktür.

IOException

Yazma işlemi başarısız oldu.

NotSupportedException

Devam eden bir yazma işlemi zaten var.

ObjectDisposedException

Bu nesne kapatıldı.

InvalidOperationException

Kimlik doğrulaması gerçekleşmedi.

Açıklamalar

bu yöntem, işlem tamamlarken engeller. İşlem tamamlarken engellemeyi önlemek için yöntemini kullanın BeginWrite .

sınıfı SslStream birden çok eşzamanlı yazma işlemini desteklemez.

Şunlara uygulanır

SslStream.Write Yöntem

Tanım

Aşırı Yüklemeler

Write(Byte[])

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

Write(Byte[], Int32, Int32)

Parametreler

Özel durumlar

Açıklamalar

Şunlara uygulanır

Ek kaynaklar