AnonymousPipeClientStream 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.
Macht die Clientseite eines anonymen Pipestreams verfügbar, der sowohl synchrone als auch asynchrone Lese- und Schreibvorgänge unterstützt (ohne Abbruchunterstützung auf Windows-Plattformen).
public ref class AnonymousPipeClientStream sealed : System::IO::Pipes::PipeStream
public sealed class AnonymousPipeClientStream : System.IO.Pipes.PipeStream
type AnonymousPipeClientStream = class
inherit PipeStream
Public NotInheritable Class AnonymousPipeClientStream
Inherits PipeStream
- Vererbung
- Vererbung
Beispiele
Im folgenden Beispiel wird mithilfe anonymer Pipes eine Zeichenfolge von einem übergeordneten Prozess an einen untergeordneten Prozess gesendet. In diesem Beispiel wird ein AnonymousPipeServerStream -Objekt in einem übergeordneten Prozess mit dem PipeDirection Wert erstellt Out. Außerdem wird ein AnonymousPipeClientStream -Objekt in einem untergeordneten Prozess mit dem PipeDirection Wert erstellt In. Der übergeordnete Prozess sendet daraufhin eine vom Benutzer bereitgestellte Zeichenfolge an den untergeordneten Prozess. Die Zeichenfolge wird der Konsole angezeigt.
Dieses Beispiel gilt für den Clientprozess, der vom Serverprozess gestartet wird. Benennen Sie die resultierende ausführbare Datei aus dem Clientcode pipeClient.exe
, und kopieren Sie sie in dasselbe Verzeichnis wie die ausführbare Serverdatei, wenn Sie dieses Beispiel ausführen. Das gesamte Codebeispiel, einschließlich des Codes für den Pipeclient und den Server, finden Sie unter Vorgehensweise: Verwenden anonymer Pipes für die lokale Interprocess-Kommunikation.
//<snippet01>
#using <System.Core.dll>
using namespace System;
using namespace System::IO;
using namespace System::IO::Pipes;
ref class PipeClient
{
public:
static void Main(array<String^>^ args)
{
if (args->Length > 1)
{
PipeStream^ pipeClient = gcnew AnonymousPipeClientStream(PipeDirection::In, args[1]);
Console::WriteLine("[CLIENT] Current TransmissionMode: {0}.",
pipeClient->TransmissionMode);
StreamReader^ sr = gcnew StreamReader(pipeClient);
// Display the read text to the console
String^ temp;
// Wait for 'sync message' from the server.
do
{
Console::WriteLine("[CLIENT] Wait for sync...");
temp = sr->ReadLine();
}
while (!temp->StartsWith("SYNC"));
// Read the server data and echo to the console.
while ((temp = sr->ReadLine()) != nullptr)
{
Console::WriteLine("[CLIENT] Echo: " + temp);
}
sr->Close();
pipeClient->Close();
}
Console::Write("[CLIENT] Press Enter to continue...");
Console::ReadLine();
}
};
int main()
{
array<String^>^ args = Environment::GetCommandLineArgs();
PipeClient::Main(args);
}
//</snippet01>
//<snippet01>
using System;
using System.IO;
using System.IO.Pipes;
class PipeClient
{
static void Main(string[] args)
{
if (args.Length > 0)
{
using (PipeStream pipeClient =
new AnonymousPipeClientStream(PipeDirection.In, args[0]))
{
Console.WriteLine("[CLIENT] Current TransmissionMode: {0}.",
pipeClient.TransmissionMode);
using (StreamReader sr = new StreamReader(pipeClient))
{
// Display the read text to the console
string temp;
// Wait for 'sync message' from the server.
do
{
Console.WriteLine("[CLIENT] Wait for sync...");
temp = sr.ReadLine();
}
while (!temp.StartsWith("SYNC"));
// Read the server data and echo to the console.
while ((temp = sr.ReadLine()) != null)
{
Console.WriteLine("[CLIENT] Echo: " + temp);
}
}
}
}
Console.Write("[CLIENT] Press Enter to continue...");
Console.ReadLine();
}
}
//</snippet01>
'<snippet01>
Imports System.IO
Imports System.IO.Pipes
Class PipeClient
Shared Sub Main(args() as String)
If args.Length > 0 Then
Using pipeClient As New AnonymousPipeClientStream(PipeDirection.In, args(0))
Console.WriteLine("[CLIENT] Current TransmissionMode: {0}.", _
pipeClient.TransmissionMode)
Using sr As New StreamReader(pipeClient)
' Display the read text to the console
Dim temp As String
' Wait for 'sync message' from the server.
Do
Console.WriteLine("[CLIENT] Wait for sync...")
temp = sr.ReadLine()
Loop While temp.StartsWith("SYNC") = False
' Read the server data and echo to the console.
temp = sr.ReadLine()
While Not temp = Nothing
Console.WriteLine("[CLIENT] Echo: " + temp)
temp = sr.ReadLine()
End While
End Using
End Using
End If
Console.Write("[CLIENT] Press Enter to continue...")
Console.ReadLine()
End Sub
End Class
'</snippet01>
Hinweise
Anonyme Pipes helfen dabei, eine sichere und sichere Interprozesskommunikation zwischen untergeordneten und übergeordneten Prozessen zu ermöglichen. Die AnonymousPipeClientStream -Klasse ermöglicht es einem untergeordneten Prozess, eine Verbindung mit einem übergeordneten Prozess herzustellen und Informationen mit diesem auszutauschen.
Anonyme Pipes sind unbenannte unidirektionale Pipes, die in der Regel Daten zwischen übergeordneten und untergeordneten Prozessen übertragen. Anonyme Rohre sind immer lokal; Sie können nicht über ein Netzwerk verwendet werden. Ein PipeDirection Wert von InOut wird nicht unterstützt, da anonyme Pipes als unidirektional definiert sind.
Anonyme Pipes unterstützen den PipeTransmissionMode.Message Lesemodus nicht.
Die Clientseite einer anonymen Pipe muss aus einem Pipehandle erstellt werden, das vom Server durch Aufrufen der GetClientHandleAsString -Methode bereitgestellt wird. Die Zeichenfolge wird dann beim Erstellen des Clientprozesses als Parameter übergeben. Aus dem Clientprozess wird es als Parameter an den AnonymousPipeClientStreampipeHandleAsString
Konstruktor übergeben.
Unter Windows werden asynchrone (überlappende) Lese- und Schreibvorgänge von anonymen Pipes nicht unterstützt (siehe https://docs.microsoft.com/en-us/windows/win32/ipc/anonymous-pipe-operations). Die AnonymousPipeClientStream Klasse plant weiterhin Die Arbeit für den Threadpool auf Windows-Plattformen, sodass asynchrone Stream Vorgänge funktionieren, aber das Abbrechen dieser Vorgänge wird nicht unterstützt.
Konstruktoren
AnonymousPipeClientStream(PipeDirection, SafePipeHandle) |
Initialisiert eine neue Instanz der AnonymousPipeClientStream-Klasse aus dem angegebenen Handle. |
AnonymousPipeClientStream(PipeDirection, String) |
Initialisiert eine neue Instanz der AnonymousPipeClientStream-Klasse mit der angegebenen Piperichtung und einer Zeichenfolgendarstellung des Pipehandles. |
AnonymousPipeClientStream(String) |
Initialisiert eine neue Instanz der AnonymousPipeClientStream-Klasse mit der angegebenen Zeichenfolgendarstellung des Pipehandles. |
Eigenschaften
CanRead |
Ruft einen Wert ab, der angibt, ob der aktuelle Stream Lesevorgänge unterstützt. (Geerbt von PipeStream) |
CanSeek |
Ruft einen Wert ab, der angibt, ob der aktuelle Stream Suchvorgänge unterstützt. (Geerbt von PipeStream) |
CanTimeout |
Ruft einen Wert ab, der bestimmt, ob für den aktuellen Stream ein Timeout möglich ist. (Geerbt von Stream) |
CanWrite |
Ruft einen Wert ab, der angibt, ob der aktuelle Stream Schreibvorgänge unterstützt. (Geerbt von PipeStream) |
InBufferSize |
Ruft die Größe des Eingangspuffers für eine Pipe in Bytes ab. (Geerbt von PipeStream) |
IsAsync |
Ruft einen Wert ab, der angibt, ob ein PipeStream -Objekt asynchron oder synchron geöffnet wurde. (Geerbt von PipeStream) |
IsConnected |
Ruft einen Wert ab, der angibt, ob ein PipeStream-Objekt verbunden ist, oder legt diesen fest. (Geerbt von PipeStream) |
IsHandleExposed |
Ruft einen Wert ab, der angibt, ob ein Handle für ein PipeStream-Objekt verfügbar gemacht wurde. (Geerbt von PipeStream) |
IsMessageComplete |
Ruft einen Wert ab, der angibt, ob in der vom letzten Lesevorgang zurückgegebenen Meldung weitere Daten vorhanden sind. (Geerbt von PipeStream) |
Length |
Ruft die Länge eines Streams in Bytes ab. (Geerbt von PipeStream) |
OutBufferSize |
Ruft die Größe des Ausgangspuffers für eine Pipe in Bytes ab. (Geerbt von PipeStream) |
Position |
Ruft die aktuelle Position des aktuellen Streams ab oder legt diese fest. (Geerbt von PipeStream) |
ReadMode |
Legt den Lesemodus für das AnonymousPipeClientStream-Objekt fest. |
ReadTimeout |
Ruft einen Wert in Millisekunden ab, der bestimmt, wie lange der Stream versucht, Lesevorgänge durchzuführen, bevor ein Timeout auftritt, oder legt diesen fest. (Geerbt von Stream) |
SafePipeHandle |
Ruft das sichere Handle für das lokale Ende der Pipe ab, die vom aktuellen PipeStream-Objekt gekapselt wird. (Geerbt von PipeStream) |
TransmissionMode |
Ruft den von der aktuellen Pipe unterstützten Pipeübertragungsmodus ab. |
WriteTimeout |
Ruft einen Wert in Millisekunden ab, der bestimmt, wie lange der Stream versucht, Schreibvorgänge durchzuführen, bevor ein Timeout auftritt, oder legt diesen fest. (Geerbt von Stream) |
Methoden
BeginRead(Byte[], Int32, Int32, AsyncCallback, Object) |
Beginnt einen asynchronen Lesevorgang. (Geerbt von PipeStream) |
BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object) |
Beginnt einen asynchronen Schreibvorgang. (Geerbt von PipeStream) |
CheckPipePropertyOperations() |
Überprüft, ob sich die Pipe in einem ordnungsgemäßen Zustand zum Abrufen oder Festlegen von Eigenschaften befindet. (Geerbt von PipeStream) |
CheckReadOperations() |
Überprüft, ob die Pipe verbunden ist, um Lesevorgänge auszuführen. (Geerbt von PipeStream) |
CheckWriteOperations() |
Überprüft, ob die Pipe verbunden ist, um Schreibvorgänge auszuführen. (Geerbt von PipeStream) |
Close() |
Schließt den aktuellen Stream und gibt alle dem aktuellen Stream zugeordneten Ressourcen frei (z. B. Sockets und Dateihandles). Anstatt diese Methode aufzurufen, stellen Sie sicher, dass der Stream ordnungsgemäß freigegeben wird. (Geerbt von Stream) |
CopyTo(Stream) |
Liest alle Bytes aus dem aktuellen Stream und schreibt sie in einen anderen Datenstrom. Beide Streamspositionen werden um die Anzahl der kopierten Bytes erweitert. (Geerbt von Stream) |
CopyTo(Stream, Int32) |
Liest alles Bytes aus dem aktuellen Datenstrom und schreibt sie unter Verwendung einer angegebenen Puffergröße in einen anderen Datenstrom. Beide Streamspositionen werden um die Anzahl der kopierten Bytes erweitert. (Geerbt von Stream) |
CopyToAsync(Stream) |
Liest die Bytes asynchron aus dem aktuellen Stream und schreibt sie in einen anderen Stream. Beide Streamspositionen werden um die Anzahl der kopierten Bytes erweitert. (Geerbt von Stream) |
CopyToAsync(Stream, CancellationToken) |
Liest die Bytes asynchron aus dem aktuellen Stream und schreibt sie unter Verwendung eines angegebenen Abbruchtokens in einen anderen Stream. Beide Streamspositionen werden um die Anzahl der kopierten Bytes erweitert. (Geerbt von Stream) |
CopyToAsync(Stream, Int32) |
Liest die Bytes asynchron aus dem aktuellen Stream und schreibt sie unter Verwendung einer angegebenen Puffergröße in einen anderen Stream. Beide Streamspositionen werden um die Anzahl der kopierten Bytes erweitert. (Geerbt von Stream) |
CopyToAsync(Stream, Int32, CancellationToken) |
Liest die Bytes asynchron aus dem aktuellen Stream und schreibt sie unter Verwendung einer angegebenen Puffergröße und eines Abbruchtokens in einen anderen Stream. Beide Streamspositionen werden um die Anzahl der kopierten Bytes erweitert. (Geerbt von Stream) |
CreateObjRef(Type) |
Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject) |
CreateWaitHandle() |
Veraltet.
Veraltet.
Veraltet.
Reserviert ein WaitHandle-Objekt. (Geerbt von Stream) |
Dispose() |
Gibt alle vom Stream verwendeten Ressourcen frei. (Geerbt von Stream) |
Dispose(Boolean) |
Gibt die von der PipeStream-Klasse verwendeten nicht verwalteten Ressourcen frei und gibt (optional) auch die verwalteten Ressourcen frei. (Geerbt von PipeStream) |
DisposeAsync() |
Gibt die nicht verwalteten Ressourcen, die von der Stream verwendet werden, asynchron frei. (Geerbt von Stream) |
EndRead(IAsyncResult) |
Beendet eine ausstehende asynchrone Leseanforderung. (Geerbt von PipeStream) |
EndWrite(IAsyncResult) |
Beendet eine ausstehende asynchrone Schreibanforderung. (Geerbt von PipeStream) |
Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
Finalize() |
Gibt nicht verwaltete Ressourcen frei, und führt andere Bereinigungsvorgänge durch, bevor die AnonymousPipeClientStream-Instanz von der Garbage Collection freigegeben wird. |
Flush() |
Löscht den Puffer für den aktuellen Stream und veranlasst die Ausgabe aller gepufferten Daten an das zugrunde liegende Gerät. (Geerbt von PipeStream) |
FlushAsync() |
Löscht sämtliche Puffer für diesen Stream asynchron und veranlasst die Ausgabe aller gepufferten Daten an das zugrunde liegende Gerät. (Geerbt von Stream) |
FlushAsync(CancellationToken) |
Löscht den Puffer für den aktuellen Stream asynchron und veranlasst die Ausgabe aller gepufferten Daten an das zugrunde liegende Gerät. (Geerbt von PipeStream) |
GetAccessControl() |
Ruft ein PipeSecurity-Objekt ab, das die Einträge in der Zugriffssteuerungsliste für die Pipe kapselt, die vom aktuellen PipeStream-Objekt beschrieben wird. (Geerbt von PipeStream) |
GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
GetLifetimeService() |
Veraltet.
Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject) |
GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
InitializeHandle(SafePipeHandle, Boolean, Boolean) |
Initialisiert ein PipeStream-Objekt aus dem angegebenen SafePipeHandle-Objekt. (Geerbt von PipeStream) |
InitializeLifetimeService() |
Veraltet.
Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject) |
MemberwiseClone() |
Erstellt eine flache Kopie des 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 einen Contract. (Geerbt von Stream) |
Read(Byte[], Int32, Int32) |
Liest einen Block von Bytes aus einem Stream und schreibt die Daten ab einer angegebenen Position für eine angegebene Länge in einen angegebenen Puffer. (Geerbt von PipeStream) |
Read(Span<Byte>) |
Liest eine Folge von Bytes aus dem aktuellen Stream, schreibt sie in ein Bytearray und erhöht die Position innerhalb des Streams um die Anzahl der gelesenen Bytes. (Geerbt von PipeStream) |
ReadAsync(Byte[], Int32, Int32) |
Liest eine Bytesequenz asynchron aus dem aktuellen Stream und setzt die Position in diesem Stream um die Anzahl der gelesenen Bytes nach vorn. (Geerbt von Stream) |
ReadAsync(Byte[], Int32, Int32, CancellationToken) |
Liest eine Folge von Bytes asynchron aus dem aktuellen Stream in ein Bytearray an die angegebene Position für eine angegebene Anzahl von Bytes, erhöht die Position im Stream um die Anzahl der gelesenen Bytes und überwacht Abbruchanfragen. (Geerbt von PipeStream) |
ReadAsync(Memory<Byte>, CancellationToken) |
Liest eine Folge von Bytes asynchron aus dem aktuellen Stream, schreibt diese in einen Bytespeicherbereich, erhöht die Position im Stream um die Anzahl der gelesenen Bytes und überwacht Abbruchanfragen. (Geerbt von PipeStream) |
ReadAtLeast(Span<Byte>, Int32, Boolean) |
Liest mindestens eine Mindestanzahl von Bytes aus dem aktuellen Stream und erhöht die Position innerhalb des Datenstroms um die Anzahl der gelesenen Bytes. (Geerbt von Stream) |
ReadAtLeastAsync(Memory<Byte>, Int32, Boolean, CancellationToken) |
Liest asynchron mindestens eine Mindestanzahl von Bytes aus dem aktuellen Stream, erhöht die Position innerhalb des Datenstroms um die Anzahl der gelesenen Bytes und überwacht Abbruchanforderungen. (Geerbt von Stream) |
ReadByte() |
Liest ein Byte aus einer Pipe. (Geerbt von PipeStream) |
ReadExactly(Byte[], Int32, Int32) |
Liest |
ReadExactly(Span<Byte>) |
Liest Bytes aus dem aktuellen Stream und erhöht die Position innerhalb des Datenstroms, bis der |
ReadExactlyAsync(Byte[], Int32, Int32, CancellationToken) |
Liest |
ReadExactlyAsync(Memory<Byte>, CancellationToken) |
Liest Bytes asynchron aus dem aktuellen Stream, erhöht die Position innerhalb des Datenstroms, bis der |
Seek(Int64, SeekOrigin) |
Legt die aktuelle Position des aktuellen Streams auf den angegebenen Wert fest. (Geerbt von PipeStream) |
SetAccessControl(PipeSecurity) |
Wendet von einem PipeSecurity-Objekt angegebene Einträge in Zugriffssteuerungslisten auf die vom aktuellen PipeStream-Objekt angegebene Pipe an. (Geerbt von PipeStream) |
SetLength(Int64) |
Legt die Länge des aktuellen Streams auf den angegebenen Wert fest. (Geerbt von PipeStream) |
ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
WaitForPipeDrain() |
Wartet, bis das andere Ende der Pipe alle gesendeten Bytes gelesen hat. (Geerbt von PipeStream) |
Write(Byte[], Int32, Int32) |
Schreibt einen Byteblock mit den Daten aus einem Puffer in den aktuellen Stream. (Geerbt von PipeStream) |
Write(ReadOnlySpan<Byte>) |
Schreibt eine Bytesequenz in den aktuellen Stream und setzt die aktuelle Position in diesem Stream um die Anzahl der geschriebenen Bytes nach vorn. (Geerbt von PipeStream) |
WriteAsync(Byte[], Int32, Int32) |
Schreibt eine Bytesequenz asynchron in den aktuellen Stream und setzt die aktuelle Position in diesem Stream um die Anzahl der geschriebenen Bytes nach vorn. (Geerbt von Stream) |
WriteAsync(Byte[], Int32, Int32, CancellationToken) |
Schreibt eine angegebene Anzahl von Bytes aus einem Bytearray ab einer angegebenen Position, erhöht die aktuelle Position in diesem Stream um die Anzahl der geschriebenen Bytes und überwacht Abbruchanforderungen. (Geerbt von PipeStream) |
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken) |
Schreibt beim Überschreiben in einer abgeleiteten Klasse eine Folge von Bytes asynchron in den aktuellen Stream und erhöht die aktuelle Position im Stream um die Anzahl der geschriebenen Bytes und überwacht Abbruchanforderungen. (Geerbt von PipeStream) |
WriteByte(Byte) |
Schreibt ein Byte in den aktuellen Stream. (Geerbt von PipeStream) |
Erweiterungsmethoden
CopyToAsync(Stream, PipeWriter, CancellationToken) |
Liest die Bytes asynchron aus der Stream-Klasse und schreibt sie unter Verwendung eines Abbruchtokens in die angegebene PipeWriter-Klasse. |
GetAccessControl(PipeStream) |
Gibt die Sicherheitsinformationen eines Pipestreams zurück |
SetAccessControl(PipeStream, PipeSecurity) |
Ändert die Sicherheitsattribute eines vorhandenen Pipestreams |
ConfigureAwait(IAsyncDisposable, Boolean) |
Konfiguriert, wie Wartezeiten auf die Aufgaben angewandt werden, die von einem asynchronen verwerfbaren Element zurückgegeben werden. |
Gilt für:
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für