DataObject.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 ini DataObject dikaitkan dengan format yang ditentukan.

Overload

Nama	Deskripsi
GetDataPresent(String, Boolean)	Menentukan apakah ini DataObject berisi data dalam format yang ditentukan atau, secara opsional, berisi data yang dapat dikonversi ke format yang ditentukan.
GetDataPresent(String)	Menentukan apakah data yang disimpan dalam ini DataObject dikaitkan dengan, atau dapat dikonversi ke, format yang ditentukan.
GetDataPresent(Type)	Menentukan apakah data yang disimpan dalam ini DataObject dikaitkan dengan, atau dapat dikonversi ke, format yang ditentukan.

GetDataPresent(String, Boolean)

Sumber:: DataObject.cs

Sumber:: DataObject.cs

Sumber:: DataObject.cs

Sumber:: DataObject.cs

Sumber:: DataObject.cs

Menentukan apakah ini DataObject berisi data dalam format yang ditentukan atau, secara opsional, berisi data yang dapat dikonversi ke format yang ditentukan.

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

public virtual bool GetDataPresent(string format, bool autoConvert);

abstract member GetDataPresent : string * bool -> bool
override this.GetDataPresent : string * bool -> bool

Public Overridable 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 ini DataObject 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.

Penerapan

GetDataPresent(String, Boolean)

Contoh

Contoh kode berikut menentukan apakah data yang saat ini disimpan dalam DataObject dikaitkan dengan format tertentu. Pertama, yang baru DataObject diinisialisasi dengan string, menentukan formatnya sebagai teks.

Kemudian dikueri DataObject untuk data yang terkait dengan format teks, menentukan autoConvert parameter sebagai false. Hasil kueri ini dicetak dalam kotak teks.

DataObject Kemudian dikueri untuk data yang terkait dengan format string, menentukan autoConvert parameter sebagai true. Hasilnya dicetak dalam kotak teks. Kode ini mengharuskan yang textBox1 telah dibuat.

private:
   void GetIfPresent3()
   {
      // Creates a new data object using a string and the text format.
      DataObject^ myDataObject = gcnew DataObject( DataFormats::Text, "Another string" );
      
      // Prints the string in a text box with autoconvert = false.
      if ( myDataObject->GetDataPresent( "System.String", false ) )
      {
         // Prints the string in a text box.
         textBox1->Text = String::Concat(
            myDataObject->GetData( "System.String", false )->ToString(), "\n" );
      }
      else
      {
         textBox1->Text = "Could not convert data to specified format\n";
      }
      
      // Prints the string in a text box with autoconvert = true.
      textBox1->Text = String::Concat( textBox1->Text,
         "With autoconvert = true, you can convert text to string format. String is: ",
         myDataObject->GetData( "System.String", true )->ToString() );
   }

private void GetIfPresent3() {
    // Creates a new data object using a string and the text format.
    DataObject myDataObject = new DataObject(DataFormats.Text, "Another string");
 
    // Prints the string in a text box with autoconvert = false.
    if(myDataObject.GetDataPresent("System.String", false)) {
       // Prints the string in a text box.
       textBox1.Text = myDataObject.GetData("System.String", false).ToString() + '\n';
    } else
        {
            textBox1.Text = "Could not convert data to specified format" + '\n';
        }

        // Prints the string in a text box with autoconvert = true.
        textBox1.Text += "With autoconvert = true, you can convert text to string format. " +
       "String is: " + myDataObject.GetData("System.String", true).ToString();
 }

Private Sub GetIfPresent3()
    ' Creates a new data object using a string and the text format.
    Dim myDataObject As New DataObject(DataFormats.Text, "Another string")
    
    ' Prints the string in a text box with autoconvert = false.
    If myDataObject.GetDataPresent("System.String", False) Then
        ' Prints the string in a text box.
        textBox1.Text = myDataObject.GetData("System.String", False).ToString() & ControlChars.Cr
    Else
        textBox1.Text = "Could not convert data to specified format" & ControlChars.Cr
    End If 
    ' Prints the string in a text box with autoconvert = true.
    textBox1.Text &= "With autoconvert = true, you can convert text to string format. " & _
                    "String is: " & myDataObject.GetData("System.String", True).ToString()
End Sub

Keterangan

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

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 konversi otomatis diatur ke false.
Parameter autoConvert adalah false dan data tidak ada dalam format DataObject yang ditentukan.

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.

Note

Jika tidak ada data yang dapat diambil, tidak ada pengecualian yang akan dilemparkan. Sebagai gantinya, false akan dikembalikan.

Lihat juga

Berlaku untuk

GetDataPresent(String)

Sumber:: DataObject.cs

Sumber:: DataObject.cs

Sumber:: DataObject.cs

Sumber:: DataObject.cs

Sumber:: DataObject.cs

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

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

public virtual bool GetDataPresent(string format);

abstract member GetDataPresent : string -> bool
override this.GetDataPresent : string -> bool

Public Overridable 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 ini DataObject dikaitkan dengan, atau dapat dikonversi ke, format yang ditentukan; jika tidak, false.

Penerapan

GetDataPresent(String)

Contoh

Contoh kode berikut menentukan apakah data yang saat ini disimpan dalam ini DataObject dikaitkan dengan, atau dapat dikonversi ke, format tertentu. Yang baru DataObject diinisialisasi dengan string dan format terkait yang ditentukan sebagai teks.

Kemudian contoh mencetak apakah data teks ada di DataObject. Kode ini mengharuskan yang textBox1 telah dibuat.

Keterangan

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

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.

Note

Jika tidak ada data yang dapat diambil, tidak ada pengecualian yang akan dilemparkan. Sebagai gantinya, false akan dikembalikan.

Lihat juga

Berlaku untuk

GetDataPresent(Type)

Sumber:: DataObject.cs

Sumber:: DataObject.cs

Sumber:: DataObject.cs

Sumber:: DataObject.cs

Sumber:: DataObject.cs

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

public:
 virtual bool GetDataPresent(Type ^ format);

public virtual bool GetDataPresent(Type format);

abstract member GetDataPresent : Type -> bool
override this.GetDataPresent : Type -> bool

Public Overridable Function GetDataPresent (format As Type) As Boolean

Parameter

format: Type

Mewakili Type format yang akan diperiksa.

Mengembalikan

Boolean

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

Penerapan

GetDataPresent(Type)

Contoh

Contoh kode berikut menentukan apakah data dari jenis yang ditentukan ada di DataObject, atau apakah data dapat dikonversi ke jenis yang ditentukan. Hasilnya ditampilkan dalam kotak teks. Kode mengharuskan yang textBox1 telah dibuat.

private:
   void GetIfPresent2()
   {
      // 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();
      
      // Determines if the DataObject has data of the Type format.
      textBox1->Text = String::Concat( "Is the specified data type available ",
         "in the DataObject? ", myDataObject->GetDataPresent( myType ), "\n" );
      
      // Retrieves the data using its type format, and displays the type.
      Object^ myObject = myDataObject->GetData( myType );
      textBox1->Text = String::Concat( textBox1->Text, "The data type stored ",
         "in the DataObject is: ", myObject->GetType()->Name );
   }

private void GetIfPresent2() {
    // 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();
 
    // Determines if the DataObject has data of the Type format.
    textBox1.Text = "Is the specified data type available in the " +
       "DataObject? " + myDataObject.GetDataPresent(myType).ToString() + '\n';
 
    // Retrieves the data using its type format, and displays the type.
    Object myObject = myDataObject.GetData(myType);
    textBox1.Text += "The data type stored in the DataObject is: " +
       myObject.GetType().Name;
 }

Private Sub GetIfPresent2()
    ' Creates a component to store in the data object.
    Dim myComponent As New 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()
    
    ' Determines if the DataObject has data of the Type format.
    textBox1.Text = "Is the specified data type available in the " & "DataObject? " & _
        myDataObject.GetDataPresent(myType).ToString() & ControlChars.Cr
    
    ' Retrieves the data using its type format, and displays the type.
    Dim myObject As Object = myDataObject.GetData(myType)
    textBox1.Text += "The data type stored in the DataObject is: " + myObject.GetType().Name
End Sub

Keterangan

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

Note

Jika tidak ada data yang dapat diambil, tidak ada pengecualian yang akan dilemparkan. Sebagai gantinya, false akan dikembalikan.

Lihat juga

Berlaku untuk

Saran dan Komentar

Apakah halaman ini membantu?