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

当前线程未处于单线程单元 (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 类只能在设置为单线程单元 (STA) 模式的线程中使用。 若要使用此类，请确保使用 Main 特性标记 STAThreadAttribute 方法。

另请参阅

适用于

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

当前线程未处于单线程单元 (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 类只能在设置为单线程单元 (STA) 模式的线程中使用。 若要使用此类，请确保使用 Main 特性标记 STAThreadAttribute 方法。

另请参阅

适用于