AuthenticatedStream Klasse
Definition
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.
Stellt Methoden zum Übergeben von Anmeldeinformationen über einen Datenstrom bereit und fordert die Authentifizierung für Clientserveranwendungen an.
public ref class AuthenticatedStream abstract : System::IO::Stream
public abstract class AuthenticatedStream : System.IO.Stream
type AuthenticatedStream = class
inherit Stream
Public MustInherit Class AuthenticatedStream
Inherits Stream
- Vererbung
- Abgeleitet
Beispiele
Im folgenden Beispiel wird die Anzeige der Eigenschaften eines authentifizierten Datenstroms veranschaulicht.
// The following class displays the properties of an authenticatedStream.
public class AuthenticatedStreamReporter
{
public static void DisplayProperties(AuthenticatedStream stream)
{
Console.WriteLine("IsAuthenticated: {0}", stream.IsAuthenticated);
Console.WriteLine("IsMutuallyAuthenticated: {0}", stream.IsMutuallyAuthenticated);
Console.WriteLine("IsEncrypted: {0}", stream.IsEncrypted);
Console.WriteLine("IsSigned: {0}", stream.IsSigned);
Console.WriteLine("IsServer: {0}", stream.IsServer);
}
}
' The following class displays the properties of an AuthenticatedStream.
Public Class AuthenticatedStreamReporter
Public Shared Sub DisplayProperties(stream As AuthenticatedStream)
Console.WriteLine("IsAuthenticated: {0}", stream.IsAuthenticated)
Console.WriteLine("IsMutuallyAuthenticated: {0}", stream.IsMutuallyAuthenticated)
Console.WriteLine("IsEncrypted: {0}", stream.IsEncrypted)
Console.WriteLine("IsSigned: {0}", stream.IsSigned)
Console.WriteLine("IsServer: {0}", stream.IsServer)
End Sub
End Class
Hinweise
Diese abstrakte Klasse stellt Methoden und Eigenschaften bereit, die für authentifizierte Datenströme üblich sind.
Authentifizierte Datenströme können Authentifizierungs-, Datensignierungs- und Verschlüsselungsdienste bereitstellen, die dazu beitragen können, die Integrität und Vertraulichkeit der mit der InnerStreamDaten übertragenen Daten aufrechtzuerhalten.
Das Sicherheitsprotokoll, das von einer Klasse implementiert wird, die von AuthenticatedStream abgeleitet ist, legt zusammen mit den vom Client und Server unterstützten Sicherheitsprotokollen die Sicherheitsfunktionen fest, die einer Anwendung zur Verfügung stehen. Die NegotiateStream und SslStream Klasse erben von AuthenticatedStream und implementieren die Sicherheitsprotokolle Negotiate bzw. Secure Sockets Layer.
Hinweise für Ausführende
Die folgenden Member müssen in einer abgeleiteten Klasse überschrieben werden: IsAuthenticated, , IsEncrypted, , IsMutuallyAuthenticated, IsServerund IsSigned.
Konstruktoren
| Name | Beschreibung |
|---|---|
| AuthenticatedStream(Stream, Boolean) |
Initialisiert eine neue Instanz der AuthenticatedStream-Klasse. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| CanRead |
Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert abgerufen, der angibt, ob der aktuelle Datenstrom das Lesen unterstützt. (Geerbt von Stream) |
| CanSeek |
Wenn eine abgeleitete Klasse überschrieben wird, wird ein Wert abgerufen, der angibt, ob der aktuelle Datenstrom die Suche unterstützt. (Geerbt von Stream) |
| CanTimeout |
Ruft einen Wert ab, der bestimmt, ob der aktuelle Datenstrom Timeout ausführen kann. (Geerbt von Stream) |
| CanWrite |
Beim Überschreiben in einer abgeleiteten Klasse wird ein Wert abgerufen, der angibt, ob der aktuelle Datenstrom das Schreiben unterstützt. (Geerbt von Stream) |
| InnerStream |
Ruft den datenstrom ab, der von diesem AuthenticatedStream zum Senden und Empfangen von Daten verwendet wird. |
| IsAuthenticated |
Ruft einen Boolean Wert ab, der angibt, ob die Authentifizierung erfolgreich war. |
| IsEncrypted |
Ruft einen Boolean Wert ab, der angibt, ob die mit dieser AuthenticatedStream Daten gesendeten Daten verschlüsselt sind. |
| IsMutuallyAuthenticated |
Ruft einen Boolean Wert ab, der angibt, ob sowohl Server als auch Client authentifiziert wurden. |
| IsServer |
Ruft einen Boolean Wert ab, der angibt, ob die lokale Seite der Verbindung als Server authentifiziert wurde. |
| IsSigned |
Ruft einen Boolean Wert ab, der angibt, ob die mit diesem Datenstrom gesendeten Daten signiert sind. |
| LeaveInnerStreamOpen |
Ruft ab, ob der von diesem AuthenticatedStream zum Senden und Empfangen von Daten verwendete Daten offen gelassen wurde. |
| Length |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, ruft die Länge in Bytes des Datenstroms ab. (Geerbt von Stream) |
| Position |
Wenn sie in einer abgeleiteten Klasse außer Kraft gesetzt wird, ruft die Position innerhalb des aktuellen Datenstroms ab oder legt sie fest. (Geerbt von Stream) |
| ReadTimeout |
Dient zum Abrufen oder Festlegen eines Werts in Millisekunden, der bestimmt, wie lange der Datenstrom vor dem Timeout zu lesen versucht. (Geerbt von Stream) |
| WriteTimeout |
Dient zum Abrufen oder Festlegen eines Werts in Millisekunden, der bestimmt, wie lange der Datenstrom versucht, vor dem Timeout zu schreiben. (Geerbt von Stream) |
Methoden
| Name | Beschreibung |
|---|---|
| BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) |
Startet einen asynchronen Lesevorgang. (Erwägen Sie stattdessen die Verwendung ReadAsync(Byte[], Int32, Int32) .) (Geerbt von Stream) |
| BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) |
Startet einen asynchronen Schreibvorgang. (Erwägen Sie stattdessen die Verwendung WriteAsync(Byte[], Int32, Int32) .) (Geerbt von Stream) |
| Close() |
Schließt den aktuellen Datenstrom und gibt alle Ressourcen (z. B. Sockets und Dateihandles) frei, die dem aktuellen Datenstrom zugeordnet sind. Anstatt diese Methode aufzurufen, stellen Sie sicher, dass der Datenstrom ordnungsgemäß verworfen ist. (Geerbt von Stream) |
| CopyTo(Stream, Int32) |
Liest die Bytes aus dem aktuellen Datenstrom und schreibt sie mithilfe einer angegebenen Puffergröße in einen anderen Datenstrom. Beide Datenströme werden um die Anzahl der kopierten Bytes erweitert. (Geerbt von Stream) |
| CopyTo(Stream) |
Liest die Bytes aus dem aktuellen Datenstrom und schreibt sie in einen anderen Datenstrom. Beide Datenströme werden um die Anzahl der kopierten Bytes erweitert. (Geerbt von Stream) |
| CopyToAsync(Stream, CancellationToken) |
Liest die Bytes asynchron aus dem aktuellen Datenstrom und schreibt sie mithilfe eines angegebenen Abbruchtokens in einen anderen Datenstrom. Beide Datenströme werden um die Anzahl der kopierten Bytes erweitert. (Geerbt von Stream) |
| CopyToAsync(Stream, Int32, CancellationToken) |
Liest asynchron die Bytes aus dem aktuellen Datenstrom und schreibt sie in einen anderen Datenstrom, wobei eine angegebene Puffergröße und ein Abbruchtoken verwendet wird. Beide Datenströme werden um die Anzahl der kopierten Bytes erweitert. (Geerbt von Stream) |
| CopyToAsync(Stream, Int32) |
Liest die Bytes asynchron aus dem aktuellen Datenstrom und schreibt sie mithilfe einer angegebenen Puffergröße in einen anderen Datenstrom. Beide Datenströme werden um die Anzahl der kopierten Bytes erweitert. (Geerbt von Stream) |
| CopyToAsync(Stream) |
Liest die Bytes asynchron aus dem aktuellen Datenstrom und schreibt sie in einen anderen Datenstrom. Beide Datenströme werden um die Anzahl der kopierten Bytes erweitert. (Geerbt von Stream) |
| CreateObjRef(Type) |
Erstellt ein Objekt, das alle relevanten Informationen enthält, die zum Generieren eines Proxys erforderlich sind, der für die Kommunikation mit einem Remoteobjekt verwendet wird. (Geerbt von MarshalByRefObject) |
| CreateWaitHandle() |
Veraltet.
Ordnet ein WaitHandle Objekt zu. (Geerbt von Stream) |
| Dispose() |
Veröffentlicht alle ressourcen, die von der Stream. (Geerbt von Stream) |
| Dispose(Boolean) |
Gibt die nicht verwalteten Ressourcen frei, die von den AuthenticatedStream verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei. |
| DisposeAsync() |
Gibt asynchron die nicht verwalteten und verwalteten Ressourcen frei, die von der AuthenticatedStream. |
| EndRead(IAsyncResult) |
Wartet auf den Abschluss des ausstehenden asynchronen Lesevorgangs. (Erwägen Sie stattdessen die Verwendung ReadAsync(Byte[], Int32, Int32) .) (Geerbt von Stream) |
| EndWrite(IAsyncResult) |
Beendet einen asynchronen Schreibvorgang. (Erwägen Sie stattdessen die Verwendung WriteAsync(Byte[], Int32, Int32) .) (Geerbt von Stream) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| Flush() |
Wenn sie in einer abgeleiteten Klasse überschrieben werden, werden alle Puffer für diesen Datenstrom gelöscht und alle gepufferten Daten auf das zugrunde liegende Gerät geschrieben. (Geerbt von Stream) |
| FlushAsync() |
Löscht asynchron alle Puffer für diesen Datenstrom und bewirkt, dass alle gepufferten Daten auf das zugrunde liegende Gerät geschrieben werden. (Geerbt von Stream) |
| FlushAsync(CancellationToken) |
Löscht asynchron alle Puffer für diesen Datenstrom, bewirkt, dass alle gepufferten Daten auf das zugrunde liegende Gerät geschrieben werden, und überwacht Abbruchanforderungen. (Geerbt von Stream) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetLifetimeService() |
Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinie für diese Instanz steuert. (Geerbt von MarshalByRefObject) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| InitializeLifetimeService() |
Ruft ein Lebensdauerdienstobjekt ab, um die Lebensdauerrichtlinie für diese Instanz zu steuern. (Geerbt von MarshalByRefObject) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| MemberwiseClone(Boolean) |
Erstellt eine flache Kopie des aktuellen MarshalByRefObject Objekts. (Geerbt von MarshalByRefObject) |
| ObjectInvariant() |
Veraltet.
Bietet Unterstützung für ein Contract. (Geerbt von Stream) |
| Read(Byte[], Int32, Int32) |
Wenn sie in einer abgeleiteten Klasse überschrieben werden, liest sie eine Bytesequenz aus dem aktuellen Datenstrom und wechselt die Position innerhalb des Datenstroms um die Anzahl der gelesenen Bytes. (Geerbt von Stream) |
| Read(Span<Byte>) |
Wenn sie in einer abgeleiteten Klasse überschrieben werden, liest sie eine Bytesequenz aus dem aktuellen Datenstrom und wechselt die Position innerhalb des Datenstroms um die Anzahl der gelesenen Bytes. (Geerbt von Stream) |
| ReadAsync(Byte[], Int32, Int32, CancellationToken) |
Liest asynchron eine Abfolge von Bytes aus dem aktuellen Datenstrom, wechselt die Position innerhalb des Datenstroms um die Anzahl der gelesenen Bytes und überwacht Abbruchanforderungen. (Geerbt von Stream) |
| ReadAsync(Byte[], Int32, Int32) |
Liest asynchron eine Abfolge von Bytes aus dem aktuellen Datenstrom und wechselt die Position innerhalb des Datenstroms um die Anzahl der gelesenen Bytes. (Geerbt von Stream) |
| ReadAsync(Memory<Byte>, CancellationToken) |
Liest asynchron eine Abfolge von Bytes aus dem aktuellen Datenstrom, wechselt die Position innerhalb des Datenstroms um die Anzahl der gelesenen Bytes und überwacht Abbruchanforderungen. (Geerbt von Stream) |
| ReadByte() |
Liest ein Byte aus dem Datenstrom und wechselt die Position innerhalb des Datenstroms um ein Byte oder gibt -1 zurück, wenn am Ende des Datenstroms. (Geerbt von Stream) |
| Seek(Int64, SeekOrigin) |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird die Position innerhalb des aktuellen Datenstroms festgelegt. (Geerbt von Stream) |
| SetLength(Int64) |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird die Länge des aktuellen Datenstroms festgelegt. (Geerbt von Stream) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
| Write(Byte[], Int32, Int32) |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird eine Bytesequenz in den aktuellen Datenstrom geschrieben und die aktuelle Position innerhalb dieses Datenstroms um die Anzahl der geschriebenen Bytes vorangestellt. (Geerbt von Stream) |
| Write(ReadOnlySpan<Byte>) |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird eine Bytesequenz in den aktuellen Datenstrom geschrieben und die aktuelle Position innerhalb dieses Datenstroms um die Anzahl der geschriebenen Bytes vorangestellt. (Geerbt von Stream) |
| WriteAsync(Byte[], Int32, Int32, CancellationToken) |
Schreibt asynchron eine Bytesequenz in den aktuellen Datenstrom, wechselt die aktuelle Position innerhalb dieses Datenstroms um die Anzahl der geschriebenen Bytes und überwacht Abbruchanforderungen. (Geerbt von Stream) |
| WriteAsync(Byte[], Int32, Int32) |
Schreibt asynchron eine Bytesequenz in den aktuellen Datenstrom und wechselt die aktuelle Position innerhalb dieses Datenstroms um die Anzahl der geschriebenen Bytes. (Geerbt von Stream) |
| WriteAsync(ReadOnlyMemory<Byte>, CancellationToken) |
Schreibt asynchron eine Bytesequenz in den aktuellen Datenstrom, wechselt die aktuelle Position innerhalb dieses Datenstroms um die Anzahl der geschriebenen Bytes und überwacht Abbruchanforderungen. (Geerbt von Stream) |
| WriteByte(Byte) |
Schreibt ein Byte in die aktuelle Position im Datenstrom und wechselt die Position innerhalb des Datenstroms um ein Byte. (Geerbt von Stream) |
Erweiterungsmethoden
| Name | Beschreibung |
|---|---|
| ConfigureAwait(IAsyncDisposable, Boolean) |
Konfiguriert, wie auf die von einem asynchronen Einweg zurückgegebenen Aufgaben gewartet wird. |