IDataObject.GetDataPresent Metode

Definisi

Ruang nama:: System.Windows.Forms

Rakitan:: System.Windows.Forms.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menentukan apakah data yang disimpan dalam instans ini dikaitkan dengan format yang ditentukan.

Overload

Nama	Deskripsi
GetDataPresent(String)	Menentukan apakah data yang disimpan dalam instans ini dikaitkan dengan, atau dapat dikonversi ke, format yang ditentukan.
GetDataPresent(Type)	Menentukan apakah data yang disimpan dalam instans ini dikaitkan dengan, atau dapat dikonversi ke, format yang ditentukan.
GetDataPresent(String, Boolean)	Menentukan apakah data yang disimpan dalam instans ini dikaitkan dengan format yang ditentukan, menggunakan nilai Boolean untuk menentukan apakah akan mengonversi data ke format.

GetDataPresent(String)

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Menentukan apakah data yang disimpan dalam instans ini dikaitkan dengan, atau dapat dikonversi ke, format yang ditentukan.

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

public bool GetDataPresent(string format);

abstract member GetDataPresent : string -> bool

Public Function GetDataPresent (format As String) As Boolean

Parameter

format: String

Format yang akan diperiksa. Lihat DataFormats untuk format yang telah ditentukan sebelumnya.

Mengembalikan

Boolean

true jika data yang disimpan dalam instans ini dikaitkan dengan, atau dapat dikonversi ke, format yang ditentukan; jika tidak false.

Contoh

Contoh ini menggunakan DataObject kelas , yang mengimplementasikan IDataObject, untuk menunjukkan penggunaan GetDataPresent metode . Pertama, ini membuat objek data menggunakan string dan Text format . Kemudian memverifikasi bahwa data ada dalam Text format dan menampilkan hasilnya dalam kotak pesan. Contoh mengasumsikan bahwa Anda telah membuat bernama FormForm1.

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

Keterangan

Panggil metode ini untuk menentukan apakah format ada dalam ini DataObject sebelum memanggil GetData. Panggil GetFormats format yang tersedia dalam instans ini.

Note

Data dapat dikonversi ke format lain jika disimpan yang menentukan bahwa konversi diizinkan, dan jika format yang diminta kompatibel dengan format tersimpan. Misalnya, data yang disimpan sebagai Unicode dapat dikonversi ke teks.

Untuk implementasi metode ini, lihat DataObject.GetDataPresent.

Lihat juga

Berlaku untuk

GetDataPresent(Type)

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Menentukan apakah data yang disimpan dalam instans ini dikaitkan dengan, atau dapat dikonversi ke, format yang ditentukan.

public:
 bool GetDataPresent(Type ^ format);

public bool GetDataPresent(Type format);

abstract member GetDataPresent : Type -> bool

Public Function GetDataPresent (format As Type) As Boolean

Parameter

format: Type

Mewakili Type format yang akan diperiksa. Lihat DataFormats untuk format yang telah ditentukan sebelumnya.

Mengembalikan

Boolean

true jika data yang disimpan dalam instans ini dikaitkan dengan, atau dapat dikonversi ke, format yang ditentukan; jika tidak, false.

Contoh

Contoh ini menggunakan DataObject kelas , yang mengimplementasikan IDataObject, untuk menunjukkan penggunaan GetDataPresent metode . Pertama, ia membuat komponen (myComponent) dan menyimpannya dalam objek data (myDataObject). Kemudian memeriksa apakah data yang ditentukan disimpan di myDataObject. Jika pengujian mengevaluasi true, pengujian menampilkan hasilnya dalam kotak pesan dan menampilkan jenis data dalam kotak teks. Contoh ini mengasumsikan bahwa Anda telah membuat Form bernama Form1 dan bernama TextBoxtextBox1 .

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

Keterangan

Panggil metode ini untuk menentukan apakah format ada dalam ini DataObject sebelum memanggil GetData. Panggil GetFormats format yang tersedia dalam instans ini.

Note

Untuk implementasi metode ini, lihat DataObject.GetDataPresent.

Lihat juga

Berlaku untuk

GetDataPresent(String, Boolean)

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Sumber:: IDataObject.cs

Menentukan apakah data yang disimpan dalam instans ini dikaitkan dengan format yang ditentukan, menggunakan nilai Boolean untuk menentukan apakah akan mengonversi data ke format.

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

Parameter

format: String

Format yang akan diperiksa. Lihat DataFormats untuk format yang telah ditentukan sebelumnya.

autoConvert: Boolean

true untuk menentukan apakah data yang disimpan dalam instans ini dapat dikonversi ke format yang ditentukan; false untuk memeriksa apakah data dalam format yang ditentukan.

Mengembalikan

Boolean

true jika data berada, atau dapat dikonversi ke, format yang ditentukan; jika tidak, false.

Contoh

Contoh ini menggunakan DataObject kelas , yang mengimplementasikan IDataObject, untuk menunjukkan penggunaan GetDataPresent metode . Pertama, ini membuat objek data (myDataObject) menggunakan string dan Text format . Kemudian mengkueri objek untuk data yang Text terkait dengan format , dengan parameter diatur autoConvert ke false. Uji coba ini gagal, dan hasilnya ditampilkan dalam kotak pesan berlabel "Pesan #1." Dalam uji coba kedua, ia mengatur parameter ke autoConverttrue. Uji coba ini berhasil, dan hasilnya ditampilkan dalam kotak pesan berlabel "Pesan #2." Contoh mengasumsikan bahwa Anda telah membuat bernama FormForm1.

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

Keterangan

Panggil metode ini untuk menentukan apakah format ada dalam ini DataObject sebelum memanggil GetData. Panggil GetFormats format yang tersedia dalam instans ini.

Metode ini mengembalikan true ketika:

Parameter autoConvert adalah true dan data dalam format yang dapat dikonversi ke format yang sesuai.
Parameternya autoConvert adalah false dan data dalam format yang sesuai.

Metode ini mengembalikan false ketika:

Parameter autoConvert adalah true dan metode ini tidak dapat menemukan data dalam format yang ditentukan, dan tidak dapat mengonversi data ke format yang ditentukan, atau data disimpan dengan autoConvert diatur ke false.
Parameternya autoConvert adalah false, dan data tidak ada dalam instans ini dalam format yang ditentukan.

Note

Untuk implementasi metode ini, lihat DataObject.GetDataPresent.

Lihat juga

Berlaku untuk

Saran dan Komentar

Apakah halaman ini membantu?