Clipboard.SetAudio Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Limpa a Área de Transferência e adiciona dados no formato WaveAudio, substituindo os dados existentes.

Sobrecargas

SetAudio(Byte[])	Limpa a Área de Transferência e adiciona uma matriz de Byte no formato WaveAudio após convertê-la para um Stream.
SetAudio(Stream)	Limpa a Área de Transferência e adiciona um Stream no formato WaveAudio.

SetAudio(Byte[])

Limpa a Área de Transferência e adiciona uma matriz de Byte no formato WaveAudio após convertê-la para um 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())

Parâmetros

audioBytes

Byte[]

Uma matriz Byte que contém os dados de áudio.

Exceções

ExternalException

Não foi possível limpar a Área de Transferência. Isso geralmente ocorre quando a Área de Transferência está sendo usada por outro processo.

ThreadStateException

O thread atual não está no modo STA (Single-Threaded Apartment). Adicione o STAThreadAttribute ao método Main do aplicativo.

ArgumentNullException

audioBytes é null.

Exemplos

O exemplo a seguir demonstra uma sobrecarga do SetAudio método semelhante a essa sobrecarga.

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

Comentários

Para recuperar dados de áudio da Área de Transferência, primeiro use o ContainsAudio método para determinar se a Área de Transferência contém dados de áudio antes de recuperá-los com o GetAudioStream método .

Observação

A Clipboard classe só pode ser usada em threads definidos como modo STA (single thread apartment). Para usar essa classe, verifique se o Main método está marcado com o STAThreadAttribute atributo .

Confira também

• WaveAudio
• ContainsAudio()
• GetAudioStream()

SetAudio(Stream)

Limpa a Área de Transferência e adiciona um Stream no formato 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)

Parâmetros

audioStream

Stream

Um Stream que contém os dados de áudio.

Exceções

ExternalException

Não foi possível limpar a Área de Transferência. Isso geralmente ocorre quando a Área de Transferência está sendo usada por outro processo.

ThreadStateException

O thread atual não está no modo STA (Single-Threaded Apartment). Adicione o STAThreadAttribute ao método Main do aplicativo.

ArgumentNullException

audioStream é null.

Exemplos

O exemplo a seguir demonstra esse membro.

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

Comentários

Para recuperar dados de áudio da Área de Transferência, primeiro use o ContainsAudio método para determinar se a Área de Transferência contém dados de áudio antes de recuperá-los com o GetAudioStream método .

Observação

A Clipboard classe só pode ser usada em threads definidos como modo STA (single thread apartment). Para usar essa classe, verifique se o Main método está marcado com o STAThreadAttribute atributo .

Confira também

• WaveAudio
• ContainsAudio()
• GetAudioStream()