NegotiateStream.Write(Byte[], Int32, Int32) 方法

定義

命名空間:

System.Net.Security

組件:

System.Net.Security.dll

來源:

NegotiateStream.cs

使用指定的緩衝區和位移，將指定數目的 Byte 寫入至基礎資料流。

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)

參數

buffer

Byte[]

Byte 陣列，提供寫入至資料流的位元組。

offset

Int32

Int32，包含 buffer 中以零起始的位置，用來開始讀取將要寫入資料流的位元組。

count

Int32

Int32，包含要從 buffer 讀取的位元組數。

例外狀況

ArgumentNullException

buffer 為 null。

ArgumentException

offset is less than 0.

-或-

offset 大於 buffer 的長度。

-或-

offset 加上計數大於 buffer 的長度。

IOException

寫入作業失敗。

-或-

使用了加密，但無法解密資料。

NotSupportedException

已經有寫入作業正在進行中。

ObjectDisposedException

此物件已關閉。

InvalidOperationException

尚未執行驗證。

範例

下列程式碼範例示範如何寫入 NegotiateStream 。

int main()
{
   
   // Establish the remote endpoint for the socket.
   // For this example, use the local machine.
   IPHostEntry^ ipHostInfo = Dns::GetHostEntry( Dns::GetHostName() );
   IPAddress^ ipAddress = ipHostInfo->AddressList[ 0 ];
   
   // Client and server use port 11000. 
   IPEndPoint^ remoteEP = gcnew IPEndPoint( ipAddress,11000 );
   
   // Create a TCP/IP socket.
   TcpClient^ client = gcnew TcpClient;
   
   // Connect the socket to the remote endpoint.
   client->Connect( remoteEP );
   Console::WriteLine( L"Client connected to {0}.", remoteEP );
   
   // Ensure the client does not close when there is 
   // still data to be sent to the server.
   client->LingerState = (gcnew LingerOption( true,0 ));
   
   // Request authentication.
   NetworkStream^ clientStream = client->GetStream();
   NegotiateStream^ authStream = gcnew NegotiateStream( clientStream );
   
   // Request authentication for the client only (no mutual authentication).
   // Authenicate using the client's default credetials.
   // Permit the server to impersonate the client to access resources on the server only.
   // Request that data be transmitted using encryption and data signing.
   authStream->AuthenticateAsClient( dynamic_cast<NetworkCredential^>(CredentialCache::DefaultCredentials), 
          L"", 
          ProtectionLevel::EncryptAndSign, 
          TokenImpersonationLevel::Impersonation );
   
   DisplayAuthenticationProperties( authStream );
   DisplayStreamProperties( authStream );
   if ( authStream->CanWrite )
   {
      
      // Encode the test data into a byte array.
      array<Byte>^message = System::Text::Encoding::UTF8->GetBytes( L"Hello from the client." );
      authStream->Write( message, 0, message->Length );
      authStream->Flush();
      Console::WriteLine( L"Sent {0} bytes.", message->Length );
   }

   
   // Close the client connection.
   authStream->Close();
   Console::WriteLine( L"Client closed." );
}

    public static void Main(String[] args)
    {
        // Establish the remote endpoint for the socket.
        // For this example, use the local machine.
        IPHostEntry ipHostInfo = Dns.GetHostEntry(Dns.GetHostName());
        IPAddress ipAddress = ipHostInfo.AddressList[0];
        // Client and server use port 11000.
        IPEndPoint remoteEP = new IPEndPoint(ipAddress,11000);
        // Create a TCP/IP socket.
       TcpClient client = new TcpClient();
        // Connect the socket to the remote endpoint.
        client.Connect(remoteEP);
        Console.WriteLine("Client connected to {0}.",
            remoteEP.ToString());
        // Ensure the client does not close when there is
        // still data to be sent to the server.
        client.LingerState = (new LingerOption(true,0));
        // Request authentication.
        NetworkStream clientStream = client.GetStream();
        NegotiateStream authStream = new NegotiateStream(clientStream);
        // Request authentication for the client only (no mutual authentication).
        // Authenicate using the client's default credetials.
        // Permit the server to impersonate the client to access resources on the server only.
        // Request that data be transmitted using encryption and data signing.
        authStream.AuthenticateAsClient(
             (NetworkCredential) CredentialCache.DefaultCredentials,
             "",
             ProtectionLevel.EncryptAndSign,
             TokenImpersonationLevel.Impersonation);
        DisplayAuthenticationProperties(authStream);
        DisplayStreamProperties(authStream);
        if (authStream.CanWrite)
        {
             // Encode the test data into a byte array.
            byte[] message = System.Text.Encoding.UTF8.GetBytes("Hello from the client.");
            authStream.Write(message, 0, message.Length);
            authStream.Flush();
            Console.WriteLine("Sent {0} bytes.", message.Length);
        }
        // Close the client connection.
        authStream.Close();
        Console.WriteLine("Client closed.");
}

備註

如果啟用加密、簽署或加密和簽署，這個方法會從緩衝區、加密、簽署或加密和簽署資料，並使用基礎資料流程加以傳輸。 如果沒有資料加密或簽署等安全性服務正在使用中，此方法會在基礎資料流程上叫用 Write 。

這個方法會在寫入作業完成時封鎖。 若要避免在作業完成時封鎖，請使用 WriteAsync 方法。

在成功驗證之前，您無法呼叫此方法。 若要進行驗證，請呼叫其中一個 AuthenticateAsClient 、 AuthenticateAsClientAsync 、 BeginAuthenticateAsClient 、 AuthenticateAsServer 、 AuthenticateAsServerAsync 或 BeginAuthenticateAsServer 方法。

類別 NegotiateStream 不支援多個同時寫入作業。 如果您嘗試在相同的資料流程上執行另一個寫入作業時啟動寫入作業， NotSupportedException 將會擲回例外狀況。