Clipboard.SetText Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Pano'nu temizler ve sonra buna metin verileri ekler.

Aşırı Yüklemeler

SetText(String)	panoyu temizler ve ardından işletim sistemine bağlı olarak veya UnicodeText biçiminde metin verileri Text ekler.
SetText(String, TextDataFormat)	Pano'nu temizler ve sonra metin verilerini belirtilen TextDataFormat değerle belirtilen biçimde ekler.

SetText(String)

panoyu temizler ve ardından işletim sistemine bağlı olarak veya UnicodeText biçiminde metin verileri Text ekler.

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)

Parametreler

text

String

Pano'ya eklenecek metin.

Özel durumlar

ExternalException

Pano temizlenemedi. Bu durum genellikle Pano başka bir işlem tarafından kullanıldığında oluşur.

ThreadStateException

Geçerli iş parçacığı tek iş parçacıklı daire (STA) modunda değil. STAThreadAttribute öğesini uygulamanızın yöntemine Main ekleyin.

ArgumentNullException

textveya Emptyşeklindedirnull.

Örnekler

Aşağıdaki örnekte yöntemin SetText bu aşırı yüklemeye benzer bir aşırı yüklemesi gösterilmektedir.

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

Açıklamalar

Bu yöntem, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ve Windows 2000'de metin verilerini UnicodeText biçiminde ekler. Aksi takdirde, bu yöntem biçiminde metin verileri Text ekler.

Pano'dan metin verilerini almak için, önce yöntemini kullanarak Pano'da ContainsText metin verilerinin bulunup bulunmadığına karar verilsin GetText .

Not

Clipboard sınıfı yalnızca tek iş parçacığı dairesi (STA) moduna ayarlanmış iş parçacıklarında kullanılabilir. Bu sınıfı kullanmak için yönteminizin Main özniteliğiyle işaretlendiğinden STAThreadAttribute emin olun.

Ayrıca bkz.

• TextDataFormat
• ContainsText
• GetText

SetText(String, TextDataFormat)

Pano'nu temizler ve sonra metin verilerini belirtilen TextDataFormat değerle belirtilen biçimde ekler.

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)

Parametreler

text

String

Pano'ya eklenecek metin.

format

TextDataFormat

Değerlerden TextDataFormat biri.

Özel durumlar

ExternalException

Pano temizlenemedi. Bu durum genellikle Pano başka bir işlem tarafından kullanıldığında oluşur.

ThreadStateException

Geçerli iş parçacığı tek iş parçacıklı daire (STA) modunda değil. STAThreadAttribute öğesini uygulamanızın yöntemine Main ekleyin.

ArgumentNullException

textveya Emptyşeklindedirnull.

InvalidEnumArgumentException

format geçerli TextDataFormat bir değer değil.

Örnekler

Aşağıdaki örnekte bu üye gösterilmektedir.

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

Açıklamalar

Pano'dan metin verilerini almak için, önce yöntemini kullanarak Pano'da ContainsText metin verilerinin bulunup bulunmadığına karar verilsin GetText .

Not

Clipboard sınıfı yalnızca tek iş parçacığı dairesi (STA) moduna ayarlanmış iş parçacıklarında kullanılabilir. Bu sınıfı kullanmak için yönteminizin Main özniteliğiyle işaretlendiğinden STAThreadAttribute emin olun.

Ayrıca bkz.

• TextDataFormat
• ContainsText
• GetText