IDataObject.SetData 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.

Belirtilen verileri ve ilişkili biçimini bu örnekte depolar.

Aşırı Yüklemeler

SetData(Object)	Biçimi için veri sınıfını kullanarak belirtilen verileri bu örnekte depolar.
SetData(String, Object)	Belirtilen verileri ve ilişkili biçimini bu örnekte depolar.
SetData(Type, Object)	Belirtilen verileri ve ilişkili sınıf türünü bu örnekte depolar.
SetData(String, Boolean, Object)	Verilerin başka bir biçime dönüştürülip dönüştürülemeyeceğini belirtmek için boole değeri kullanarak belirtilen verileri ve ilişkili biçimini bu örnekte depolar.

SetData(Object)

Biçimi için veri sınıfını kullanarak belirtilen verileri bu örnekte depolar.

public:
 void SetData(System::Object ^ data);

public void SetData (object data);

public void SetData (object? data);

abstract member SetData : obj -> unit

Public Sub SetData (data As Object)

Parametreler

data: Object

Depoacak veriler.

Örnekler

Bu örnekte yönteminin DataObject kullanımını SetData 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 veri nesnesinde depolanıp depolanmadığını denetler ve sonucu bir ileti kutusunda görüntüler. Örnekte adlı Form1bir Form oluşturduğunuz varsayılır.

private:
   void SetData1()
   {
      // Creates a component to store in the data object.
      Component^ myComponent = gcnew Component;
      
      // Creates a data object.
      DataObject^ myDataObject = gcnew DataObject;
      
      // Adds the component to the data object.
      myDataObject->SetData( myComponent );
      
      // Checks whether data of the specified type is in the data object.
      Type^ myType = myComponent->GetType();
      String^ myMessageText;
      if ( myDataObject->GetDataPresent( myType ) )
      {
         myMessageText = "Data of type " + myType->Name +
            " is present in the data object";
      }
      else
      {
         myMessageText = "Data of type " + myType->Name +
            " is not present in the data object";
      }
      
      // Displays the result in a message box.
      MessageBox::Show( myMessageText, "The Test Result" );
   }

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

    // Adds the component to the data object.
    myDataObject.SetData(myComponent);
 
    // Checks whether data of the specified type is in the data object.
    Type myType = myComponent.GetType();
    string myMessageText;
    if(myDataObject.GetDataPresent(myType))
         myMessageText = "Data of type " + myType.Name + 
            " is present in the data object";
    else
        myMessageText = "Data of type " + myType.Name +
            " is not present in the data object";

    // Displays the result in a message box.
    MessageBox.Show(myMessageText, "The Test Result"); 
}

Private Sub SetData1()
   ' Creates a component to store in the data object.
   Dim myComponent As New System.ComponentModel.Component()
   
   ' Creates a data object.
   Dim myDataObject As New DataObject()
   
   ' Adds the component to the data object.
   myDataObject.SetData(myComponent)
   
   ' Checks whether data of the specified type is in the data object.
   Dim myType As Type = myComponent.GetType()
   Dim myMessageText As String
   If myDataObject.GetDataPresent(myType) Then
      myMessageText = "Data of type " + myType.Name + " is present in the data object"
   Else
      myMessageText = "Data of type " + myType.Name + " is not present in the data object"
   End If

   ' Displays the result in a message box.
   MessageBox.Show(myMessageText, "The Test Result")
End Sub

Açıklamalar

Biçimi veri sınıfından türetilir.

Bu yöntem kullanılarak depolanan veriler alındığında uyumlu bir biçime dönüştürülebilir.

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

Ayrıca bkz.

Şunlara uygulanır

SetData(String, Object)

Belirtilen verileri ve ilişkili biçimini bu örnekte depolar.

public:
 void SetData(System::String ^ format, System::Object ^ data);

public void SetData (string format, object data);

public void SetData (string format, object? data);

abstract member SetData : string * obj -> unit

Public Sub SetData (format As String, data As Object)

Parametreler

format: String

Verilerle ilişkili biçim. Önceden tanımlanmış biçimler için bkz DataFormats .

data: Object

Depoacak veriler.

Örnekler

Bu örnekte yönteminin DataObject kullanımını SetData göstermek için uygulayan IDataObjectsınıfı kullanılır. İlk olarak, bir veri nesnesi (myDataObject) oluşturur ve biçimini belirten nesnede bir dize depolar UnicodeText . Ardından, biçimi belirten Text nesnede depolanan verileri alır, böylece veriler biçime Text dönüştürülür. Sonuç bir ileti kutusunda görüntülenir. Bu örnekte adlı Form1bir Form oluşturduğunuz varsayılır.

private:
   void SetData2()
   {
      // Creates a data object.
      DataObject^ myDataObject = gcnew DataObject;
      
      // Stores a string, specifying the UnicodeText format.
      myDataObject->SetData( DataFormats::UnicodeText, "Hello World!" );
      
      // Retrieves the data by specifying the Text format.
      String^ myMessageText = "The data type is " +
         myDataObject->GetData( DataFormats::Text )->GetType()->Name;
      
      // Displays the result.
      MessageBox::Show( myMessageText, "The Test Result" );
   }

private void SetData2() 
{
    // Creates a data object.
    DataObject myDataObject = new DataObject();
 
    // Stores a string, specifying the UnicodeText format.
    myDataObject.SetData(DataFormats.UnicodeText, "Hello World!");
 
    // Retrieves the data by specifying the Text format.
    string myMessageText = "The data type is " + myDataObject.GetData(DataFormats.Text).GetType().Name;

    // Displays the result.
    MessageBox.Show(myMessageText, "The Test Result");
}

Private Sub SetData2()
   ' Creates a data object.
   Dim myDataObject As New DataObject()
   
   ' Stores a string, specifying the UnicodeText format.
   myDataObject.SetData(DataFormats.UnicodeText, "Hello World!")
   
   ' Retrieves the data by specifying the Text format.
   Dim myMessageText As String = "The data type is " & _
             myDataObject.GetData(DataFormats.Text).GetType().Name
   
   ' Displays the result.
   MessageBox.Show(myMessageText, "The Test Result")
End Sub

Açıklamalar

Hedef uygulamanın biçimini bilmiyorsanız, bu yöntemi kullanarak verileri birden çok biçimde depolayabilirsiniz.

Bu yöntem kullanılarak depolanan veriler alındığında uyumlu bir biçime dönüştürülebilir.

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

Ayrıca bkz.

Şunlara uygulanır

SetData(Type, Object)

Belirtilen verileri ve ilişkili sınıf türünü bu örnekte depolar.

public:
 void SetData(Type ^ format, System::Object ^ data);

public void SetData (Type format, object data);

public void SetData (Type format, object? data);

abstract member SetData : Type * obj -> unit

Public Sub SetData (format As Type, data As Object)

Parametreler

format: Type

Type Verilerle ilişkili biçimi temsil eden bir. Önceden tanımlanmış biçimler için bkz DataFormats .

data: Object

Depoacak veriler.

Örnekler

Bu örnekte yönteminin DataObject kullanımını SetData göstermek için uygulayan IDataObjectsınıfı kullanılır. İlk olarak, veri biçimini belirtmek için kullanarak myType bir bileşen oluşturur (myComponent) ve bunu bir veri nesnesinde ()myDataObject depolar. Ardından, belirtilen türdeki verilerin nesnede depolanıp depolanmadığını denetler ve sonucu bir ileti kutusunda görüntüler. Örnekte adlı Form1bir Form oluşturduğunuz varsayılır.

private:
   void SetData3()
   {
      // Creates a component.
      Component^ myComponent = gcnew Component;
      
      // Gets the type of the component.
      Type^ myType = myComponent->GetType();
      
      // Creates a data object.
      DataObject^ myDataObject = gcnew DataObject;
      
      // Stores the component in the data object.
      myDataObject->SetData( myType, myComponent );
      
      // Checks whether data of the specified type is in the data object.
      String^ myMessageText;
      if ( myDataObject->GetDataPresent( myType ) )
      {
         myMessageText = "Data of type " + myType->Name +
            " is stored in the data object";
      }
      else
      {
         myMessageText = "No data of type " + myType->Name +
            " is stored in the data object";
      }
      
      // Displays the result.
      MessageBox::Show( myMessageText, "The Test Result" );
   }

private void SetData3() 
{
    // Creates a component.
    Component myComponent = new Component();
 
    // Gets the type of the component.
    Type myType = myComponent.GetType();
 
    // Creates a data object.
    DataObject myDataObject = new DataObject();
 
    // Stores the component in the data object.
    myDataObject.SetData(myType, myComponent);
 
    // Checks whether data of the specified type is in the data object.
    string myMessageText;
    if(myDataObject.GetDataPresent(myType))
        myMessageText = "Data of type " + myType.Name + 
            " is stored in the data object";
    else
        myMessageText = "No data of type " + myType.Name +
            " is stored in the data object";
            
    // Displays the result.
    MessageBox.Show(myMessageText, "The Test Result");
}

Private Sub SetData3()
   ' Creates a component.
   Dim myComponent As New System.ComponentModel.Component()
   
   ' Gets the type of the component.
   Dim myType As Type = myComponent.GetType()
   
   ' Creates a data object.
   Dim myDataObject As New DataObject()
   
   ' Stores the component in the data object.
   myDataObject.SetData(myType, myComponent)
   
   ' Checks whether data of the specified type is in the data object.
   Dim myMessageText As String
   If myDataObject.GetDataPresent(myType) Then
      myMessageText = "Data of type " & myType.Name & " is stored in the data object"
   Else
      myMessageText = "No data of type " & myType.Name & " is stored in the data object"
   End If
   
   ' Displays the result.
   MessageBox.Show(myMessageText, "The Test Result")
End Sub

Açıklamalar

Hedef uygulamanın biçimini bilmiyorsanız, bu yöntemi kullanarak verileri birden çok biçimde depolayabilirsiniz.

Bu yöntem kullanılarak depolanan veriler alındığında uyumlu bir biçime dönüştürülebilir.

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

Ayrıca bkz.

Şunlara uygulanır

SetData(String, Boolean, Object)

Verilerin başka bir biçime dönüştürülip dönüştürülemeyeceğini belirtmek için boole değeri kullanarak belirtilen verileri ve ilişkili biçimini bu örnekte depolar.

public:
 void SetData(System::String ^ format, bool autoConvert, System::Object ^ data);

public void SetData (string format, bool autoConvert, object data);

public void SetData (string format, bool autoConvert, object? data);

abstract member SetData : string * bool * obj -> unit

Public Sub SetData (format As String, autoConvert As Boolean, data As Object)

Parametreler

format: String

Verilerle ilişkili biçim. Önceden tanımlanmış biçimler için bkz DataFormats .

autoConvert: Boolean

true verilerin başka bir biçime dönüştürülmesini sağlamak için; aksi takdirde , false.

data: Object

Depoacak veriler.

Örnekler

Bu örnekte yönteminin DataObject kullanımını SetData göstermek için uygulayan IDataObjectsınıfı kullanılır. İlk olarak, bir veri nesnesi (myDataObject) oluşturur ve parametresi olarak ayarlanmış falsebir UnicodeText dize autoConvert depolar. Ardından nesnede depolanan verilerle ilişkili biçimleri alır ve sonucu bir ileti kutusunda görüntüler. Verilerle ilişkili tek biçim biçimidir UnicodeText . Bu örnekte adlı Form1bir Form oluşturduğunuz varsayılır.

private:
   void SetData4()
   {
      // Creates a new data object.
      DataObject^ myDataObject = gcnew DataObject;

      // Adds UnicodeText string to the object, and set the autoConvert
      // parameter to false.
      myDataObject->SetData( DataFormats::UnicodeText, false, "My text String*" );

      // Gets the data format(s) in the data object.
      array<String^>^arrayOfFormats = myDataObject->GetFormats();

      // Stores the results in a string.
      String^ theResult = "The format(s) associated with the data are: \n";
      for ( int i = 0; i < arrayOfFormats->Length; i++ )
         theResult = theResult + arrayOfFormats[ i ], " \n";

      // Show the results in a message box.
      MessageBox::Show( theResult );
   }

       private void SetData4() 
       {
           // Creates a new data object.
           DataObject myDataObject = new DataObject();

           // Adds UnicodeText string to the object, and set the autoConvert 
           // parameter to false.
           myDataObject.SetData(DataFormats.UnicodeText, false, "My text string");

           // Gets the data format(s) in the data object.
           String[] arrayOfFormats = myDataObject.GetFormats();

           // Stores the results in a string.
           string theResult = "The format(s) associated with the data are:" + '\n';
           for(int i=0; i<arrayOfFormats.Length; i++)
               theResult += arrayOfFormats[i] + '\n';
           
           // Show the results in a message box. 
           MessageBox.Show(theResult);
       }

Private Sub SetData4()
    ' Creates a new data object.
    Dim myDataObject As New DataObject()

    ' Adds UnicodeText string to the object, and set the autoConvert
    ' parameter to false.
    myDataObject.SetData(DataFormats.UnicodeText, False, "My text string")

    ' Gets the data format(s) in the data object.
    Dim arrayOfFormats As [String]() = myDataObject.GetFormats()

    ' Stores the results in a string.
    Dim theResult As String = "The format(s) associated with the data are:" + _
            ControlChars.Cr
    Dim i As Integer
    For i = 0 To arrayOfFormats.Length - 1
        theResult += arrayOfFormats(i) + ControlChars.Cr
    Next i
    ' Show the results in a message box. 
    MessageBox.Show(theResult)
End Sub

Açıklamalar

Hedef uygulamanın biçimini bilmiyorsanız, bu yöntemi kullanarak verileri birden çok biçimde depolayabilirsiniz.

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

Ayrıca bkz.

Şunlara uygulanır

IDataObject.SetData Yöntem

Tanım

Aşırı Yüklemeler

SetData(Object)

Parametreler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

SetData(String, Object)

Parametreler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

SetData(Type, Object)

Parametreler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

SetData(String, Boolean, Object)

Parametreler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Ek kaynaklar