Clipboard.SetText Metod

Definition

Namnområde:
System.Windows.Forms
Sammansättning:
System.Windows.Forms.dll

Rensar Urklipp och lägger sedan till textdata i det.

Överlagringar

Name Description
SetText(String)

Rensar Urklipp och lägger sedan till textdata i Text formatet eller UnicodeText beroende på operativsystemet.
SetText(String, TextDataFormat)

Rensar Urklipp och lägger sedan till textdata i det format som anges av det angivna TextDataFormat värdet.

SetText(String)

Källa:
Clipboard.cs
Källa:
Clipboard.cs
Källa:
Clipboard.cs
Källa:
Clipboard.cs
Källa:
Clipboard.cs

Rensar Urklipp och lägger sedan till textdata i Text formatet eller UnicodeText beroende på operativsystemet.

public:
 static void SetText(System::String ^ text);
public static void SetText(string text);
static member SetText : string -> unit
Public Shared Sub SetText (text As String)

Parametrar

text
String

Texten som ska läggas till i Urklipp.

Undantag

ExternalException

Urklipp kunde inte rensas. Detta inträffar vanligtvis när Urklipp används av en annan process.

ThreadStateException

Den aktuella tråden är inte i sta-läge (single-threaded apartment). Lägg till i STAThreadAttribute programmets Main metod.

ArgumentNullException

text är null eller Empty.

Exempel

I följande exempel visas en överlagring av metoden som liknar den här överbelastningen SetText .

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

Kommentarer

Den här metoden lägger till textdata i formatet UnicodeText på Windows XP Home Edition, Windows XP Professional, Windows Server 2003 och Windows 2000. I annat fall lägger den här metoden till textdata i Text formatet.

Om du vill hämta textdata från Urklipp använder ContainsText du först metoden för att avgöra om Urklipp innehåller textdata innan du hämtar dem med GetText metoden.

Note

Klassen Clipboard kan endast användas i trådar som är inställda på sta-läge (single thread apartment). Om du vill använda den här klassen kontrollerar du att din Main-metod har markerats med attributet STAThreadAttribute.

Se även

Gäller för

SetText(String, TextDataFormat)

Källa:
Clipboard.cs
Källa:
Clipboard.cs
Källa:
Clipboard.cs
Källa:
Clipboard.cs
Källa:
Clipboard.cs

Rensar Urklipp och lägger sedan till textdata i det format som anges av det angivna TextDataFormat värdet.

public:
 static void SetText(System::String ^ text, System::Windows::Forms::TextDataFormat format);
public static void SetText(string text, System.Windows.Forms.TextDataFormat format);
static member SetText : string * System.Windows.Forms.TextDataFormat -> unit
Public Shared Sub SetText (text As String, format As TextDataFormat)

Parametrar

text
String

Texten som ska läggas till i Urklipp.

format
TextDataFormat

Ett av TextDataFormat värdena.

Undantag

ExternalException

Urklipp kunde inte rensas. Detta inträffar vanligtvis när Urklipp används av en annan process.

ThreadStateException

Den aktuella tråden är inte i sta-läge (single-threaded apartment). Lägg till i STAThreadAttribute programmets Main metod.

ArgumentNullException

text är null eller Empty.

InvalidEnumArgumentException

format är inte ett giltigt TextDataFormat värde.

Exempel

I följande exempel visas den här medlemmen.

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

Kommentarer

Om du vill hämta textdata från Urklipp använder ContainsText du först metoden för att avgöra om Urklipp innehåller textdata innan du hämtar dem med GetText metoden.

Note

Klassen Clipboard kan endast användas i trådar som är inställda på sta-läge (single thread apartment). Om du vill använda den här klassen kontrollerar du att din Main-metod har markerats med attributet STAThreadAttribute.

Se även

Gäller för