Clipboard.SetAudio 方法

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

清除剪貼簿，然後加入 WaveAudio 格式的資料，取代現有資料。

多載

SetAudio(Byte[])	清除剪貼簿，並將 Byte 陣列轉換為 WaveAudio，然後再以 Stream 格式加入至剪貼簿。
SetAudio(Stream)	清除剪貼簿，然後加入 Stream 格式的 WaveAudio。

SetAudio(Byte[])

清除剪貼簿，並將 Byte 陣列轉換為 WaveAudio，然後再以 Stream 格式加入至剪貼簿。

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())

參數

audioBytes

Byte[]

Byte 陣列，包含音訊資料。

例外狀況

ExternalException

無法清除剪貼簿。 這通常在剪貼簿由另一個處理序使用時發生。

ThreadStateException

目前執行緒 (Thread) 不是在單一執行緒 Apartment (STA) 模式。 將 STAThreadAttribute 加入至應用程式的 Main 方法。

ArgumentNullException

audioBytes 為 null。

範例

下列範例示範方法的多 SetAudio 載，類似于這個多載。

// 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

備註

若要從剪貼簿擷取音訊資料，請先使用 ContainsAudio 方法來判斷剪貼簿是否包含音訊資料，然後再使用 方法擷 GetAudioStream 取音訊資料。

注意

類別 Clipboard 只能在設定為單一線程 Apartment (STA) 模式的執行緒中使用。 若要使用這個類別，請確定您的 Main 方法已標示 STAThreadAttribute 為 屬性。

另請參閱

• WaveAudio
• ContainsAudio()
• GetAudioStream()

SetAudio(Stream)

清除剪貼簿，然後加入 Stream 格式的 WaveAudio。

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)

參數

audioStream

Stream

Stream，包含音訊資料。

例外狀況

ExternalException

無法清除剪貼簿。 這通常在剪貼簿由另一個處理序使用時發生。

ThreadStateException

目前執行緒 (Thread) 不是在單一執行緒 Apartment (STA) 模式。 將 STAThreadAttribute 加入至應用程式的 Main 方法。

ArgumentNullException

audioStream 為 null。

範例

下列範例示範此成員。

// 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

備註

若要從剪貼簿擷取音訊資料，請先使用 ContainsAudio 方法來判斷剪貼簿是否包含音訊資料，然後再使用 方法擷 GetAudioStream 取音訊資料。

注意

類別 Clipboard 只能在設定為單一線程 Apartment (STA) 模式的執行緒中使用。 若要使用這個類別，請確定您的 Main 方法已標示 STAThreadAttribute 為 屬性。

另請參閱

• WaveAudio
• ContainsAudio()
• GetAudioStream()