DataObject Sınıf

Tanım

public ref class DataObject : System::Windows::Forms::IDataObject

public ref class DataObject : System::Runtime::InteropServices::ComTypes::IDataObject, System::Windows::Forms::IDataObject

[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
public class DataObject : System.Windows.Forms.IDataObject

[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
public class DataObject : System.Runtime.InteropServices.ComTypes.IDataObject, System.Windows.Forms.IDataObject

[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
type DataObject = class
    interface IDataObject
    interface UnsafeNativeMethods.IOleDataObject

[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
type DataObject = class
    interface IDataObject
    interface IDataObject

[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
type DataObject = class
    interface IDataObject
    interface IDataObject
    interface IDataObject.Interface

[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
type DataObject = class
    interface IDataObject
    interface IDataObject.Interface
    interface IDataObject

Public Class DataObject
Implements IDataObject

Public Class DataObject
Implements IDataObject, IDataObject

Devralma

Object

DataObject

Öznitelikler

ClassInterfaceAttribute

Uygulamalar

IDataObject IDataObject

Örnekler

Aşağıdaki kod örneği içindeki DataObjectverileri ekler. İlk olarak, yeni DataObject bir oluşturulur ve içinde bir bileşen depolanır. Ardından, uygun türdeki verilerin içinde DataObjectmevcut olup olmadığını denetler. Sonuç bir metin kutusunda görüntülenir. Bu kod, bunun oluşturulmasını gerektirir textBox1 .

private:
   void AddMyData3()
   {
      // Creates a component to store in the data object.
      Component^ myComponent = gcnew Component;
      
      // Creates a new data object.
      DataObject^ myDataObject = gcnew DataObject;
      
      // Adds the component to the DataObject.
      myDataObject->SetData( myComponent );
      
      // Prints whether data of the specified type is in the DataObject.
      Type^ myType = myComponent->GetType();
      if ( myDataObject->GetDataPresent( myType ) )
      {
         textBox1->Text = String::Concat( "Data of type ", myType,
            " is present in the DataObject" );
      }
      else
      {
         textBox1->Text = String::Concat( "Data of type ", myType,
            " is not present in the DataObject" );
      }
   }

private void AddMyData3() {
    // Creates a component to store in the data object.
    Component myComponent = new Component();
 
    // Creates a new data object.
    DataObject myDataObject = new DataObject();
 
    // Adds the component to the DataObject.
    myDataObject.SetData(myComponent);
 
    // Prints whether data of the specified type is in the DataObject.
    Type myType = myComponent.GetType();
    if(myDataObject.GetDataPresent(myType))
       textBox1.Text = "Data of type " + myType.ToString() + 
       " is present in the DataObject";
    else
       textBox1.Text = "Data of type " + myType.ToString() +
       " is not present in the DataObject";
 }

Private Sub AddMyData3()
    ' Creates a component to store in the data object.
    Dim myComponent As New Component()
    
    ' Creates a new data object.
    Dim myDataObject As New DataObject()
    
    ' Adds the component to the DataObject.
    myDataObject.SetData(myComponent)
    
    ' Prints whether data of the specified type is in the DataObject.
    Dim myType As Type = myComponent.GetType()
    If myDataObject.GetDataPresent(myType) Then
        textBox1.Text = "Data of type " & myType.ToString() & _
            " is present in the DataObject"
    Else
        textBox1.Text = "Data of type " & myType.ToString() & _
            " is not present in the DataObject"
    End If
End Sub

Sonraki örnek, içinde DataObjectdepolanan verileri alır. İlk olarak, metin verileriyle yeni DataObject bir oluşturulur. Ardından veriler alınır ve biçimi dize olarak belirtilir ve bir metin kutusunda görüntülenir. Veri biçimi otomatik olarak metinden dizeye dönüştürülür. Bu kod, bunun oluşturulmasını gerektirir textBox1 .

void GetMyData2()
{
   // Creates a new data object using a string and the text format.
   DataObject^ myDataObject = gcnew DataObject( DataFormats::Text,"Text to Store" );
   
   // Prints the string in a text box.
   textBox1->Text = myDataObject->GetData( DataFormats::Text )->ToString();
}

private void GetMyData2() {
    // Creates a new data object using a string and the text format.
    DataObject myDataObject = new DataObject(DataFormats.Text, "Text to Store");
 
    // Prints the string in a text box.
    textBox1.Text = myDataObject.GetData(DataFormats.Text).ToString();
 }

Private Sub GetMyData2()
    ' Creates a new data object using a string and the text format.
    Dim myDataObject As New DataObject(DataFormats.Text, "Text to Store")
    
    ' Prints the string in a text box.
    textBox1.Text = myDataObject.GetData(DataFormats.Text).ToString()
End Sub

Açıklamalar

DataObject IDataObject, yöntemleri veri aktarımı için biçimden bağımsız bir mekanizma sağlayan arabirimini uygular.

A DataObject genellikle ve ile Clipboard sürükle ve bırak işlemlerinde kullanılır. DataObject sınıfı, arabiriminin önerilen uygulamasını IDataObject sağlar. Kendinizi uygulamak IDataObject yerine sınıfını DataObject kullanmanız önerilir.

Içinde farklı biçimlerde birden çok veri parçası depolanabilir DataObject. Veriler, ilişkili biçimine göre a'dan DataObject alınır. Hedef uygulama bilinmediğinden, verileri birden çok biçime yerleştirerek DataObject verilerin bir uygulama için uygun biçimde olma olasılığını artırabilirsiniz. Önceden tanımlanmış biçimler için bkz DataFormats . sınıfının bir örneğini DataFormats.Format oluşturarak kendi biçiminizi uygulayabilirsiniz.

Bir içinde DataObjectveri depolamak için, verileri oluşturucuya veya çağrısına SetDatageçirin. Aynı DataObjectöğesine birden çok biçimde veri ekleyebilirsiniz. Eklediğiniz verilerin yalnızca yerel biçiminde alınmasını istiyorsanız parametresi olarak ayarlanmış falseolarak çağırın.SetData(String, Boolean, Object)autoConvert

Veri, ile GetDatauyumlu olan herhangi bir biçimde bir DataObject içinden alınabilir. Örneğin, metin Unicode'a dönüştürülebilir. Verileri depolandığı biçimde almak için parametresi olarak ayarlanmış falseolarak çağırın.GetDataautoConvert

Verilerin hangi biçimlerde depolandığını belirlemek için çağrısında bulunur GetFormats. Bir biçimin kullanılabilir olup olmadığını belirlemek için istediğiniz biçimle çağrısı GetDataPresent yapın.

.NET Framework 2.0'da sınıfı, DataObject verilerle ortak biçimlerde çalışmayı kolaylaştıran ek yöntemler sağlar. öğesine belirli bir biçimde veri eklemek için DataObjectgibi SetTextuygun SetFormat yöntemini kullanın. 'dan DataObjectbelirli bir biçimin verilerini almak için, önce uygun ContainsFormat yöntemini (örneğinContainsText) çağırarak bu biçimde veri içerip içermediğini DataObject belirleyin, ardından verileri içeriyorsa almak DataObject için uygun GetFormat yöntemini (örneğinGetText) çağırın.

Oluşturucular

Yöntemler

Belirtik Arabirim Kullanımları

Şunlara uygulanır

Ayrıca bkz.

• Clipboard
• IDataObject
• DataFormats