IDataObject.GetDataPresent Yöntem

Başvuru

Tanım

Ad Alanı:: System.Windows.Forms

Bütünleştirilmiş Kod:: System.Windows.Forms.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Bu örnekte depolanan verilerin belirtilen biçimle ilişkili olup olmadığını belirler.

Aşırı Yüklemeler

GetDataPresent(String)	Bu örnekte depolanan verilerin belirtilen biçimle ilişkili olup olmadığını veya bu biçime dönüştürülebileceğini belirler.
GetDataPresent(Type)	Bu örnekte depolanan verilerin belirtilen biçimle ilişkili olup olmadığını veya bu biçime dönüştürülebileceğini belirler.
GetDataPresent(String, Boolean)	Bu örnekte depolanan verilerin belirtilen biçimle ilişkili olup olmadığını belirler ve verilerin biçime dönüştürülip dönüştürülmeyeceğini belirlemek için boole değeri kullanılır.

GetDataPresent(String)

Bu örnekte depolanan verilerin belirtilen biçimle ilişkili olup olmadığını veya bu biçime dönüştürülebileceğini belirler.

public:
 bool GetDataPresent(System::String ^ format);

public bool GetDataPresent (string format);

abstract member GetDataPresent : string -> bool

Public Function GetDataPresent (format As String) As Boolean

Parametreler

format: String

Denetlenecek biçim. Önceden tanımlanmış biçimler için bkz DataFormats .

Döndürülenler

Boolean

true Bu örnekte depolanan veriler belirtilen biçimle ilişkiliyse veya bu biçime dönüştürülebiliyorsa; aksi takdirde false.

Örnekler

Bu örnekte yönteminin DataObject kullanımını GetDataPresent göstermek için uygulayan IDataObjectsınıfı kullanılır. İlk olarak, bir dize ve Text biçim kullanarak bir veri nesnesi oluşturur. Ardından verilerin biçiminde olduğunu Text doğrular ve sonuçları bir ileti kutusunda görüntüler. Örnekte adlı Form1bir Form oluşturduğunuz varsayılır.

private:
   void TestDataObject()
   {
      // Creates a new data object using a string and the Text format.
      String^ myString = "Hello World!";
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,myString );

      // Checks whether the data is present in the Text format and displays the result.
      if ( myDataObject->GetDataPresent( DataFormats::Text ) )
            MessageBox::Show( "The stored data is in the Text format.", "Test Result" );
      else
            MessageBox::Show( "The stored data is not in the Text format.", "Test Result" );
   }

       private void TestDataObject() 
       {
           // Creates a new data object using a string and the Text format.
           string myString = "Hello World!";
           DataObject myDataObject = new DataObject(DataFormats.Text, myString);

           // Checks whether the data is present in the Text format and displays the result.
           if (myDataObject.GetDataPresent(DataFormats.Text))
               MessageBox.Show("The stored data is in the Text format." , "Test Result");
           else
               MessageBox.Show("The stored data is not in the Text format.", "Test Result");
       }

Private Sub TestDataObject()
    ' Creates a new data object using a string and the Text format.
    Dim myString As New String("Hello World!")
    Dim myDataObject As New DataObject(DataFormats.Text, myString)

    ' Checks whether the data is present in the Text format and displays the result.
    If (myDataObject.GetDataPresent(DataFormats.Text)) Then
        MessageBox.Show("The stored data is in the Text format.", "Test Result")
    Else
        MessageBox.Show("The stored data is not in the Text format.", "Test Result")
    End If
End Sub

Açıklamalar

çağırmadan önce bu yöntemi çağırarak GetDatabir biçimin var DataObject olup olmadığını belirleyin. Bu örnekte kullanılabilen biçimleri çağırın GetFormats .

Not

Veriler, dönüştürmeye izin verileceğini belirterek depolanmışsa ve istenen biçim depolanmış biçimle uyumluysa başka bir biçime dönüştürülebilir. Örneğin, Unicode olarak depolanan veriler metne dönüştürülebilir.

Bu yöntemin uygulanması için bkz DataObject.GetDataPresent. .

Ayrıca bkz.

Şunlara uygulanır

GetDataPresent(Type)

Bu örnekte depolanan verilerin belirtilen biçimle ilişkili olup olmadığını veya bu biçime dönüştürülebileceğini belirler.

public:
 bool GetDataPresent(Type ^ format);

public bool GetDataPresent (Type format);

abstract member GetDataPresent : Type -> bool

Public Function GetDataPresent (format As Type) As Boolean

Parametreler

format: Type

Type Denetlenecek biçimi temsil eden. Önceden tanımlanmış biçimler için bkz DataFormats .

Döndürülenler

Boolean

true Bu örnekte depolanan veriler belirtilen biçimle ilişkiliyse veya bu biçime dönüştürülebiliyorsa; aksi takdirde , false.

Örnekler

Bu örnekte yönteminin DataObject kullanımını GetDataPresent göstermek için uygulayan IDataObjectsınıfı kullanılır. İlk olarak, bir bileşen oluşturur (myComponent) ve bunu bir veri nesnesinde (myDataObject) depolar. Ardından belirtilen verilerin içinde myDataObjectdepolanıp depolanmadığını denetler. Test sonucunu trueverirse, sonucu bir ileti kutusunda ve veri türünü bir metin kutusunda görüntüler. Bu örnekte, zaten adlandırılmış ve adlandırılmış textBox1Form1 bir Form TextBox oluşturduğunuz varsayılır.

private:
   void GetDataPresent2()
   {
      // Creates a component to store in the data object.
      Component^ myComponent = gcnew Component;

      // Creates a new data object and assigns it the component.
      DataObject^ myDataObject = gcnew DataObject( myComponent );

      // Creates a type to store the type of data.
      Type^ myType = myComponent->GetType();

      // Checks whether the specified data type exists in the object.
      if ( myDataObject->GetDataPresent( myType ) )
      {
         MessageBox::Show( "The specified data is stored in the data object." );

         // Displays the type of data.
         textBox1->Text = "The data type is " + myDataObject->GetData( myType )->GetType()->Name + ".";
      }
      else
            MessageBox::Show( "The specified data is not stored in the data object." );
   }

       private void GetDataPresent2() 
       {
           // Creates a component to store in the data object.
           Component myComponent = new Component();

           // Creates a new data object and assigns it the component.
           DataObject myDataObject = new DataObject(myComponent);

           // Creates a type to store the type of data.
           Type myType = myComponent.GetType();

           // Checks whether the specified data type exists in the object.
           if (myDataObject.GetDataPresent(myType))
           {
               MessageBox.Show("The specified data is stored in the data object.");
               // Displays the type of data.
               textBox1.Text = "The data type is " + myDataObject.GetData(myType).GetType().Name + ".";
           }
           else
           {
               MessageBox.Show("The specified data is not stored in the data object.");
           }
       }

Private Sub GetDataPresent2()
    ' Creates a component to store in the data object.
    Dim myComponent As New System.ComponentModel.Component()

    ' Creates a new data object and assigns it the component.
    Dim myDataObject As New DataObject(myComponent)

    'Creates a type to store the type of data.
    Dim myType As Type = myComponent.GetType()

    ' Checks whether the specified data type exists in the object.
    If myDataObject.GetDataPresent(myType) Then
        MessageBox.Show("The specified data is stored in the data object.")
        ' Displays the type of data.
        TextBox1.Text = "The data type is " & myDataObject.GetData(myType).GetType().Name & "."
    Else
        MessageBox.Show("The specified data is not stored in the data object.")
    End If
End Sub

Açıklamalar

çağırmadan önce bu yöntemi çağırarak GetDatabir biçimin var DataObject olup olmadığını belirleyin. Bu örnekte kullanılabilen biçimleri çağırın GetFormats .

Not

Bu yöntemin uygulanması için bkz DataObject.GetDataPresent. .

Ayrıca bkz.

Şunlara uygulanır

GetDataPresent(String, Boolean)

Bu örnekte depolanan verilerin belirtilen biçimle ilişkili olup olmadığını belirler ve verilerin biçime dönüştürülip dönüştürülmeyeceğini belirlemek için boole değeri kullanılır.

public:
 bool GetDataPresent(System::String ^ format, bool autoConvert);

public bool GetDataPresent (string format, bool autoConvert);

abstract member GetDataPresent : string * bool -> bool

Public Function GetDataPresent (format As String, autoConvert As Boolean) As Boolean

Parametreler

format: String

Denetlenecek biçim. Önceden tanımlanmış biçimler için bkz DataFormats .

autoConvert: Boolean

true bu örnekte depolanan verilerin belirtilen biçime dönüştürülip dönüştürülemeyeceğini belirlemek için; false verinin belirtilen biçimde olup olmadığını denetlemek için.

Döndürülenler

Boolean

true veriler belirtilen biçimdeyse veya bu biçime dönüştürülebiliyorsa; aksi takdirde , false.

Örnekler

Bu örnekte yönteminin DataObject kullanımını GetDataPresent göstermek için uygulayan IDataObjectsınıfı kullanılır. İlk olarak, bir dize ve Text biçim kullanarak bir veri nesnesi (myDataObject) oluşturur. Ardından, parametresi olarak ayarlanmış falseşekilde, biçimiyle autoConvert ilişkili Text veriler için nesnesini sorgular. Bu deneme başarısız olur ve sonuç "İleti #1" etiketli bir ileti kutusunda görüntülenir. İkinci denemede parametresini autoConvert olarak trueayarlar. Bu deneme başarılı olur ve sonuç "İleti #2" etiketli bir ileti kutusunda görüntülenir. Örnekte adlı Form1bir Form oluşturduğunuz varsayılır.

private:
   void GetDataPresent3()
   {
      // Creates a new data object using a string and the Text format.
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,"My String" );

      // Checks whether the string can be displayed with autoConvert equal to false.
      if ( myDataObject->GetDataPresent( "System::String", false ) )
            MessageBox::Show( myDataObject->GetData( "System::String", false )->ToString(), "Message #1" );
      else
            MessageBox::Show( "Cannot convert data to the specified format with autoConvert set to false.", "Message #1" );

      // Displays the string with autoConvert equal to true.
      MessageBox::Show( "Now that autoConvert is true, you can convert " + myDataObject->GetData( "System::String", true ) + " to string format.", "Message #2" );
   }

       private void GetDataPresent3() 
       {
           // Creates a new data object using a string and the Text format.
           DataObject myDataObject = new DataObject(DataFormats.Text, "My String");

           // Checks whether the string can be displayed with autoConvert equal to false.
           if(myDataObject.GetDataPresent("System.String", false)) 
               MessageBox.Show(myDataObject.GetData("System.String", false).ToString(), "Message #1");
           else
               MessageBox.Show("Cannot convert data to the specified format with autoConvert set to false.", "Message #1");

           // Displays the string with autoConvert equal to true.
           MessageBox.Show("Now that autoConvert is true, you can convert " + 
               myDataObject.GetData("System.String", true).ToString() + " to string format.","Message #2");
       }

Private Sub GetDataPresent3()
    ' Creates a new data object using a string and the Text format.
    Dim myDataObject As New DataObject(DataFormats.Text, "My String")

    ' Checks whether the string can be displayed with autoConvert equal to false.
    If myDataObject.GetDataPresent("System.String", False) Then
        MessageBox.Show(myDataObject.GetData("System.String", False).ToString() + ".", "Message #1")
    Else
        MessageBox.Show("Cannot convert data to the specified format with autoConvert set to false.", "Message #1")
    End If
    ' Displays the string with autoConvert equal to true.
    MessageBox.Show(("Now that autoConvert is true, you can convert " + myDataObject.GetData("System.String", _
         True).ToString() + " to string format."), "Message #2")

End Sub

Açıklamalar

çağırmadan önce bu yöntemi çağırarak GetDatabir biçimin var DataObject olup olmadığını belirleyin. Bu örnekte kullanılabilen biçimleri çağırın GetFormats .

Bu yöntem şu durumlarda döndürür true :

autoConvert parametresidir true ve veriler uygun biçime dönüştürülebilecek bir biçimdedir.
autoConvert parametresidir false ve veriler uygun biçimdedir.

Bu yöntem şu durumlarda döndürür false :

autoConvert parametresidir true ve bu yöntem belirtilen biçimdeki verileri bulamıyor ve verileri belirtilen biçime dönüştüremiyor veya veri olarak ayarlanmış falseolarak autoConvert depolandı.
autoConvert parametresidir falseve veriler bu örnekte belirtilen biçimde mevcut değildir.

Not

Bu yöntemin uygulanması için bkz DataObject.GetDataPresent. .

Ayrıca bkz.

Şunlara uygulanır

IDataObject.GetDataPresent Yöntem

Tanım

Aşırı Yüklemeler

GetDataPresent(String)

Parametreler

Döndürülenler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

GetDataPresent(Type)

Parametreler

Döndürülenler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

GetDataPresent(String, Boolean)

Parametreler

Döndürülenler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Geri Bildirim

Ek kaynaklar