Clipboard.GetText Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Recupera dati di testo dagli Appunti.
Overload
| GetText() |
Recupera dati di testo dagli Appunti nel formato Text o UnicodeText, in base al sistema operativo. |
| GetText(TextDataFormat) |
Recupera dati di testo dagli Appunti nel formato indicato dal valore TextDataFormat specificato. |
GetText()
Recupera dati di testo dagli Appunti nel formato Text o UnicodeText, in base al sistema operativo.
public:
static System::String ^ GetText();public static string GetText ();static member GetText : unit -> stringPublic Shared Function GetText () As StringRestituisce
Dati di testo degli Appunti o Empty se gli Appunti non contengono dati nel formato Text o UnicodeText, in base al sistema operativo.
Eccezioni
Impossibile cancellare gli Appunti. Ciò si verifica solitamente se un altro processo sta utilizzando gli Appunti.
Il thread corrente non è in modalità Single Thread Apartment (STA). Aggiungere la classe STAThreadAttribute al metodo Main dell'applicazione.
Esempio
Nell'esempio GetText seguente viene illustrato un overload del metodo simile a questo overload.
// 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
Commenti
Questo metodo restituisce dati di testo nel UnicodeText formato in Windows XP Home Edition, Windows XP Professional, Windows Server 2003 e Windows 2000. In caso contrario, questo metodo restituisce dati di testo nel Text formato.
Usare il ContainsText metodo per determinare se gli Appunti contengono dati di testo prima di recuperarli con questo metodo.
Usare il SetText metodo per aggiungere dati di testo agli Appunti.
Nota
La Clipboard classe può essere usata solo nei thread impostati sulla modalità single thread apartment (STA). Per usare questa classe, assicurarsi che il Main metodo sia contrassegnato con l'attributo STAThreadAttribute .
Vedi anche
Si applica a
GetText(TextDataFormat)
Recupera dati di testo dagli Appunti nel formato indicato dal valore TextDataFormat specificato.
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 -> stringPublic Shared Function GetText (format As TextDataFormat) As StringParametri
- format
- TextDataFormat
Uno dei valori di TextDataFormat.
Restituisce
Dati di testo degli appunti o Empty se gli Appunti non contengono dati nel formato specificato.
Eccezioni
Impossibile cancellare gli Appunti. Ciò si verifica solitamente se un altro processo sta utilizzando gli Appunti.
Il thread corrente non è in modalità Single Thread Apartment (STA). Aggiungere la classe STAThreadAttribute al metodo Main dell'applicazione.
format non è un valore valido di TextDataFormat.
Esempio
Nell'esempio seguente viene illustrato questo membro.
// 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
Commenti
Usare il ContainsText metodo per determinare se gli Appunti contengono dati di testo prima di recuperarli con questo metodo.
Usare il SetText metodo per aggiungere dati di testo agli Appunti.
Nota
La Clipboard classe può essere usata solo nei thread impostati sulla modalità single thread apartment (STA). Per usare questa classe, assicurarsi che il Main metodo sia contrassegnato con l'attributo STAThreadAttribute .
