Clipboard.GetText Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Recupera datos de texto del Portapapeles.

Sobrecargas

GetText()	Recupera del Portapapeles datos de texto que tengan el formato Text o UnicodeText, en función del sistema operativo.
GetText(TextDataFormat)	Recupera del Portapapeles datos de texto con el formato que indica el valor de TextDataFormat especificado.

GetText()

Recupera del Portapapeles datos de texto que tengan el formato Text o UnicodeText, en función del sistema operativo.

public:
 static System::String ^ GetText();

public static string GetText ();

static member GetText : unit -> string

Public Shared Function GetText () As String

Devoluciones

String

Datos de texto del Portapapeles o Empty si el Portapapeles no contiene datos con el formato Text o UnicodeText, dependiendo del sistema operativo.

Excepciones

ExternalException

No se ha podido vaciar el Portapapeles. Esto ocurre normalmente cuando otro proceso utiliza el Portapapeles.

ThreadStateException

El subproceso actual no está en el modo de contenedor uniproceso (STA). Agregue STAThreadAttribute al método Main de la aplicación.

Ejemplos

En el ejemplo siguiente se muestra una sobrecarga del GetText método similar a esta sobrecarga.

// Demonstrates SetText, ContainsText, and GetText.
public String SwapClipboardHtmlText(String replacementHtmlText)
{
    String returnHtmlText = null;
    if (Clipboard.ContainsText(TextDataFormat.Html))
    {
        returnHtmlText = Clipboard.GetText(TextDataFormat.Html);
        Clipboard.SetText(replacementHtmlText, TextDataFormat.Html);
    }
    return returnHtmlText;
}

' Demonstrates SetText, ContainsText, and GetText.
Public Function SwapClipboardHtmlText( _
    ByVal replacementHtmlText As String) As String

    Dim returnHtmlText As String = Nothing

    If (Clipboard.ContainsText(TextDataFormat.Html)) Then
        returnHtmlText = Clipboard.GetText(TextDataFormat.Html)
        Clipboard.SetText(replacementHtmlText, TextDataFormat.Html)
    End If

    Return returnHtmlText

End Function

Comentarios

Este método devuelve datos de texto con el UnicodeText formato en Windows XP Home Edition, Windows XP Professional, Windows Server 2003 y Windows 2000. De lo contrario, este método devuelve datos de texto con el Text formato .

Use el ContainsText método para determinar si el Portapapeles contiene datos de texto antes de recuperarlos con este método.

Use el SetText método para agregar datos de texto al Portapapeles.

Nota

La clase Clipboard solo se puede usar en subprocesos establecidos en modo de subprocesamiento controlado simple (STA). Para usar esta clase, asegúrese de que el método Main está marcado con el atributo STAThreadAttribute.

Consulte también

• TextDataFormat
• ContainsText
• SetText

GetText(TextDataFormat)

Recupera del Portapapeles datos de texto con el formato que indica el valor de TextDataFormat especificado.

public:
 static System::String ^ GetText(System::Windows::Forms::TextDataFormat format);

public static string GetText (System.Windows.Forms.TextDataFormat format);

static member GetText : System.Windows.Forms.TextDataFormat -> string

Public Shared Function GetText (format As TextDataFormat) As String

Parámetros

format

TextDataFormat

Uno de los valores de TextDataFormat.

Devoluciones

String

Datos de texto del Portapapeles o Empty si el Portapapeles no contiene datos con el formato especificado.

Excepciones

ExternalException

No se ha podido vaciar el Portapapeles. Esto ocurre normalmente cuando otro proceso utiliza el Portapapeles.

ThreadStateException

El subproceso actual no está en el modo de contenedor uniproceso (STA). Agregue STAThreadAttribute al método Main de la aplicación.

InvalidEnumArgumentException

format no es un valor TextDataFormat válido.

Ejemplos

En el ejemplo siguiente se muestra este miembro.

// Demonstrates SetText, ContainsText, and GetText.
public String SwapClipboardHtmlText(String replacementHtmlText)
{
    String returnHtmlText = null;
    if (Clipboard.ContainsText(TextDataFormat.Html))
    {
        returnHtmlText = Clipboard.GetText(TextDataFormat.Html);
        Clipboard.SetText(replacementHtmlText, TextDataFormat.Html);
    }
    return returnHtmlText;
}

' Demonstrates SetText, ContainsText, and GetText.
Public Function SwapClipboardHtmlText( _
    ByVal replacementHtmlText As String) As String

    Dim returnHtmlText As String = Nothing

    If (Clipboard.ContainsText(TextDataFormat.Html)) Then
        returnHtmlText = Clipboard.GetText(TextDataFormat.Html)
        Clipboard.SetText(replacementHtmlText, TextDataFormat.Html)
    End If

    Return returnHtmlText

End Function

Comentarios

Use el ContainsText método para determinar si el Portapapeles contiene datos de texto antes de recuperarlos con este método.

Use el SetText método para agregar datos de texto al Portapapeles.

Nota

La clase Clipboard solo se puede usar en subprocesos establecidos en modo de subprocesamiento controlado simple (STA). Para usar esta clase, asegúrese de que el método Main está marcado con el atributo STAThreadAttribute.

Consulte también

• TextDataFormat
• ContainsText
• SetText