Clipboard.GetText Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Pano'dan metin verilerini alır.

Aşırı Yüklemeler

Name	Description
GetText(TextDataFormat)	Pano'dan metin verilerini belirtilen TextDataFormat değerle belirtilen biçimde alır.
GetText()	İşletim sistemine bağlı olarak Pano'dan Text veya UnicodeText biçiminde metin verilerini alır.

GetText(TextDataFormat)

Kaynak:

Clipboard.cs

Pano'dan metin verilerini belirtilen TextDataFormat değerle belirtilen biçimde alır.

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

Parametreler

format

TextDataFormat

Değerlerden TextDataFormat biri.

Döndürülenler

String

Pano metin verileri veya Empty Pano belirtilen biçimde veri içermiyorsa.

Özel durumlar

ExternalException

Pano temizlenemiyor. 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.

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

ContainsText Bu yöntemle almadan önce Pano'da metin verilerinin bulunup bulunmadığına karar vermek için yöntemini kullanın.

Pano'ya SetText metin verileri eklemek için yöntemini kullanın.

Note

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 Main yönteminizin STAThreadAttribute özniteliğiyle işaretlendiğinden emin olun.

Ayrıca bkz.

• TextDataFormat
• ContainsText
• SetText

GetText()

Kaynak:

Clipboard.cs

İşletim sistemine bağlı olarak Pano'dan Text veya UnicodeText biçiminde metin verilerini alır.

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

public static string GetText();

static member GetText : unit -> string

Public Shared Function GetText () As String

Döndürülenler

String

Pano metin verileri veya Empty Pano işletim sistemine bağlı olarak veya Text biçiminde veri UnicodeText içermiyorsa.

Özel durumlar

ExternalException

Pano temizlenemiyor. 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.

Örnekler

Aşağıdaki örnek, yöntemin GetText bu aşırı yüklemeye benzer bir aşırı yüklemesini gösterir.

// 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 UnicodeText biçiminde metin verileri döndürür. Aksi takdirde, bu yöntem biçiminde metin verileri Text döndürür.

ContainsText Bu yöntemle almadan önce Pano'da metin verilerinin bulunup bulunmadığına karar vermek için yöntemini kullanın.

Pano'ya SetText metin verileri eklemek için yöntemini kullanın.

Note

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 Main yönteminizin STAThreadAttribute özniteliğiyle işaretlendiğinden emin olun.

Ayrıca bkz.

• TextDataFormat
• ContainsText
• SetText