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

GetText()	İşletim sistemine bağlı olarak Pano'dan Text veya UnicodeText biçiminde metin verilerini alır.
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.

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 UnicodeText biçiminde veri Text içermiyorsa.

Ö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. öğesini STAThreadAttribute uygulamanızın yöntemine Main ekleyin.

Örnekler

Aşağıdaki örnekte yöntemin GetText 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 döndürür. Aksi takdirde, bu yöntem biçimindeki metin verilerini Text döndürür.

ContainsText Bu yöntemle almadan önce Pano'da metin verileri olup olmadığını belirlemek için yöntemini kullanın.

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

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
• SetText

GetText(TextDataFormat)

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 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. öğesini STAThreadAttribute 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 verileri olup olmadığını belirlemek için yöntemini kullanın.

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

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
• SetText