NegotiateStream.Length プロパティ

定義

基になるストリームの長さを取得します。Gets the length of the underlying stream.

public:
 virtual property long Length { long get(); };
public override long Length { get; }
member this.Length : int64
Public Overrides ReadOnly Property Length As Long

プロパティ値

基になるストリームの長さを指定する Int64A Int64 that specifies the length of the underlying stream.

例外

基になるストリームが NetworkStream の場合、このプロパティの値の取得はサポートされていません。Getting the value of this property is not supported when the underlying stream is a NetworkStream.

次のコード例は、このプロパティの値を表示する方法を示しています。The following code example demonstrates displaying the value of this property.

static void DisplayStreamProperties( NegotiateStream^ stream )
{
   Console::WriteLine( L"Can read: {0}", stream->CanRead );
   Console::WriteLine( L"Can write: {0}", stream->CanWrite );
   Console::WriteLine( L"Can seek: {0}", stream->CanSeek );
   try
   {
      
      // If the underlying stream supports it, display the length.
      Console::WriteLine( L"Length: {0}", stream->Length );
   }
   catch ( NotSupportedException^ ) 
   {
      Console::WriteLine( L"Cannot get the length of the underlying stream." );
   }

   if ( stream->CanTimeout )
   {
      Console::WriteLine( L"Read time-out: {0}", stream->ReadTimeout );
      Console::WriteLine( L"Write time-out: {0}", stream->WriteTimeout );
   }
}


 static void DisplayStreamProperties(NegotiateStream stream)
{
     Console.WriteLine("Can read: {0}", stream.CanRead);
     Console.WriteLine("Can write: {0}", stream.CanWrite);
     Console.WriteLine("Can seek: {0}", stream.CanSeek);
     try 
     {
         // If the underlying stream supports it, display the length.
         Console.WriteLine("Length: {0}", stream.Length);
     } catch (NotSupportedException)
     {
             Console.WriteLine("Cannot get the length of the underlying stream.");
     }
     
     if (stream.CanTimeout)
     {
         Console.WriteLine("Read time-out: {0}", stream.ReadTimeout);
         Console.WriteLine("Write time-out: {0}", stream.WriteTimeout);
     }
}

注釈

このプロパティは、基になるストリームの Length プロパティを呼び出すことによって返される値を返します。This property returns the value returned by invoking the Length property on the underlying stream. 基になるストリームがシーク可能でない場合、通常、このプロパティは例外をスローします。If the underlying stream is not seekable, this property will typically throw an exception. 基になるストリームのランタイム型によって、スローされる例外の実行時の型が決まります。The run-time type of the underlying stream determines the run-time type of the exception that is thrown.

適用対象