Clipboard.SetAudio Methode

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Löscht die Zwischenablage und fügt dann Daten im WaveAudio-Format hinzu und ersetzt die vorhandenen Daten.

Überlädt

SetAudio(Byte[])

Löscht die Zwischenablage und fügt dann ein Byte-Array im WaveAudio-Format hinzu, nachdem es in einen Stream konvertiert wurde.
SetAudio(Stream)

Löscht die Zwischenablage und fügt dann einen Stream im WaveAudio-Format hinzu.

SetAudio(Byte[])

Löscht die Zwischenablage und fügt dann ein Byte-Array im WaveAudio-Format hinzu, nachdem es in einen Stream konvertiert wurde.

public:
 static void SetAudio(cli::array <System::Byte> ^ audioBytes);
public static void SetAudio (byte[] audioBytes);
static member SetAudio : byte[] -> unit
Public Shared Sub SetAudio (audioBytes As Byte())

Parameter

audioBytes
Byte[]

Ein Byte-Array, das die Audiodaten enthält.

Ausnahmen

ExternalException

Die Zwischenablage konnte nicht gelöscht werden. Dies tritt i. d. R. auf, wenn die Zwischenablage von einem anderen Prozess verwendet wird.

ThreadStateException

Der aktuelle Thread befindet sich nicht im STA-Modus (Singlethread-Apartment). Fügen Sie der Main-Methode der Anwendung das STAThreadAttribute hinzu.

ArgumentNullException

audioBytes ist null.

Beispiele

Im folgenden Beispiel wird eine Überladung der -Methode veranschaulicht, die SetAudio dieser Überladung ähnelt.

// Demonstrates SetAudio, ContainsAudio, and GetAudioStream.
public System.IO.Stream SwapClipboardAudio(
    System.IO.Stream replacementAudioStream)
{
    System.IO.Stream returnAudioStream = null;
    if (Clipboard.ContainsAudio())
    {
        returnAudioStream = Clipboard.GetAudioStream();
        Clipboard.SetAudio(replacementAudioStream);
    }
    return returnAudioStream;
}

' Demonstrates SetAudio, ContainsAudio, and GetAudioStream.
Public Function SwapClipboardAudio( _
    ByVal replacementAudioStream As System.IO.Stream) _
    As System.IO.Stream

    Dim returnAudioStream As System.IO.Stream = Nothing

    If (Clipboard.ContainsAudio()) Then
        returnAudioStream = Clipboard.GetAudioStream()
        Clipboard.SetAudio(replacementAudioStream)
    End If

    Return returnAudioStream

End Function

Hinweise

Verwenden Sie zum Abrufen von Audiodaten aus der Zwischenablage zunächst die ContainsAudio -Methode, um zu bestimmen, ob die Zwischenablage Audiodaten enthält, bevor Sie sie mit der GetAudioStream -Methode abrufen.

Hinweis

Die Clipboard-Klasse kann nur in Threads verwendet werden, die auf den STA-Modus (Single Thread Apartment) festgelegt sind. Um diese Klasse zu verwenden, stellen Sie sicher, dass Ihre Main-Methode mit dem STAThreadAttribute-Attribut gekennzeichnet ist.

Weitere Informationen

Gilt für:

SetAudio(Stream)

Löscht die Zwischenablage und fügt dann einen Stream im WaveAudio-Format hinzu.

public:
 static void SetAudio(System::IO::Stream ^ audioStream);
public static void SetAudio (System.IO.Stream audioStream);
static member SetAudio : System.IO.Stream -> unit
Public Shared Sub SetAudio (audioStream As Stream)

Parameter

audioStream
Stream

Ein Stream, der die Audiodaten enthält.

Ausnahmen

ExternalException

Die Zwischenablage konnte nicht gelöscht werden. Dies tritt i. d. R. auf, wenn die Zwischenablage von einem anderen Prozess verwendet wird.

ThreadStateException

Der aktuelle Thread befindet sich nicht im STA-Modus (Singlethread-Apartment). Fügen Sie der Main-Methode der Anwendung das STAThreadAttribute hinzu.

ArgumentNullException

audioStream ist null.

Beispiele

Im folgenden Beispiel wird dieser Member veranschaulicht.

// Demonstrates SetAudio, ContainsAudio, and GetAudioStream.
public System.IO.Stream SwapClipboardAudio(
    System.IO.Stream replacementAudioStream)
{
    System.IO.Stream returnAudioStream = null;
    if (Clipboard.ContainsAudio())
    {
        returnAudioStream = Clipboard.GetAudioStream();
        Clipboard.SetAudio(replacementAudioStream);
    }
    return returnAudioStream;
}

' Demonstrates SetAudio, ContainsAudio, and GetAudioStream.
Public Function SwapClipboardAudio( _
    ByVal replacementAudioStream As System.IO.Stream) _
    As System.IO.Stream

    Dim returnAudioStream As System.IO.Stream = Nothing

    If (Clipboard.ContainsAudio()) Then
        returnAudioStream = Clipboard.GetAudioStream()
        Clipboard.SetAudio(replacementAudioStream)
    End If

    Return returnAudioStream

End Function

Hinweise

Verwenden Sie zum Abrufen von Audiodaten aus der Zwischenablage zunächst die ContainsAudio -Methode, um zu bestimmen, ob die Zwischenablage Audiodaten enthält, bevor Sie sie mit der GetAudioStream -Methode abrufen.

Hinweis

Die Clipboard-Klasse kann nur in Threads verwendet werden, die auf den STA-Modus (Single Thread Apartment) festgelegt sind. Um diese Klasse zu verwenden, stellen Sie sicher, dass Ihre Main-Methode mit dem STAThreadAttribute-Attribut gekennzeichnet ist.

Weitere Informationen

Gilt für: