IDataObject.SetData Metoda

Reference

Definice

Obor názvů:: System.Windows.Forms

Sestavení:: System.Windows.Forms.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Ukládá zadaná data a jejich přidružený formát v tomto případě.

Přetížení

SetData(Object)	Ukládá zadaná data v tomto případě pomocí třídy dat pro formát.
SetData(String, Object)	Ukládá zadaná data a jejich přidružený formát v tomto případě.
SetData(Type, Object)	Ukládá zadaná data a jejich přidružený typ třídy v tomto případě.
SetData(String, Boolean, Object)	Ukládá zadaná data a jejich přidružený formát v tomto případě pomocí logické hodnoty k určení, zda lze data převést do jiného formátu.

SetData(Object)

Ukládá zadaná data v tomto případě pomocí třídy dat pro formát.

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)

Parametry

data: Object

Data, která se mají uložit.

Příklady

Tento příklad používá DataObject třídu , která implementuje IDataObject, k předvedení použití SetData metody . Nejprve vytvoří komponentu (myComponent) a uloží ji do datového objektu (myDataObject). Potom zkontroluje, jestli jsou zadaná data uložená v datovém objektu, a zobrazí výsledek v okně se zprávou. Příklad předpokládá, že jste vytvořili objekt s Form názvem Form1.

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

Poznámky

Formát je odvozen z datové třídy.

Data uložená pomocí této metody lze při načtení převést do kompatibilního formátu.

Implementaci této metody najdete v tématu DataObject.SetData.

Viz také

Platí pro

SetData(String, Object)

Ukládá zadaná data a jejich přidružený formát v tomto případě.

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)

Parametry

format: String

Formát přidružený k datům. Viz DataFormats informace o předdefinovaných formátech.

data: Object

Data, která se mají uložit.

Příklady

Tento příklad používá DataObject třídu , která implementuje IDataObject, k předvedení použití SetData metody . Nejprve vytvoří datový objekt (myDataObject) a uloží řetězec do objektu, který určuje UnicodeText formát. Potom načte data uložená v objektu určujícím Text formát, takže se data převedou do Text formátu . Výsledek se zobrazí v okně se zprávou. Tento příklad předpokládá, že jste vytvořili objekt s Form názvem Form1.

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

Poznámky

Pokud neznáte formát cílové aplikace, můžete pomocí této metody ukládat data ve více formátech.

Data uložená pomocí této metody lze při načtení převést do kompatibilního formátu.

Implementaci této metody najdete v tématu DataObject.SetData.

Viz také

Platí pro

SetData(Type, Object)

Ukládá zadaná data a jejich přidružený typ třídy v tomto případě.

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)

Parametry

format: Type

A Type představující formát přidružený k datům. Viz DataFormats informace o předdefinovaných formátech.

data: Object

Data, která se mají uložit.

Příklady

Tento příklad používá DataObject třídu , která implementuje IDataObject, k předvedení použití SetData metody . Nejprve vytvoří komponentu (myComponent) a uloží ji do datového objektu (myDataObject), pomocí myType příkazu určí formát dat. Poté zkontroluje, zda jsou data zadaného typu uložena v objektu, a zobrazí výsledek v okně se zprávou. Příklad předpokládá, že jste vytvořili objekt s Form názvem Form1.

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

Poznámky

Pokud neznáte formát cílové aplikace, můžete pomocí této metody ukládat data ve více formátech.

Data uložená pomocí této metody lze při načtení převést do kompatibilního formátu.

Implementaci této metody najdete v tématu DataObject.SetData.

Viz také

Platí pro

SetData(String, Boolean, Object)

Ukládá zadaná data a jejich přidružený formát v tomto případě pomocí logické hodnoty k určení, zda lze data převést do jiného formátu.

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)

Parametry

format: String

Formát přidružený k datům. Viz DataFormats informace o předdefinovaných formátech.

autoConvert: Boolean

trueumožnit převod dat do jiného formátu; v opačném případě . false

data: Object

Data, která se mají uložit.

Příklady

Tento příklad používá DataObject třídu , která implementuje IDataObject, k předvedení použití SetData metody . Nejprve vytvoří datový objekt (myDataObject) a uloží UnicodeText do něj řetězec s parametrem nastaveným autoConvert na false. Potom načte formát nebo formáty přidružené k datům uloženým v objektu a zobrazí výsledek v okně se zprávou. Jediný formát přidružený k datům je UnicodeText formát . Tento příklad předpokládá, že jste vytvořili objekt s Form názvem Form1.

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

Poznámky

Pokud neznáte formát cílové aplikace, můžete pomocí této metody ukládat data ve více formátech.

Implementaci této metody najdete v tématu DataObject.SetData.

Viz také

Platí pro

Sdílet prostřednictvím

IDataObject.SetData Metoda

Definice

Přetížení

SetData(Object)

Parametry

Příklady

Poznámky

Viz také

Platí pro

SetData(String, Object)

Parametry

Příklady

Poznámky

Viz také

Platí pro

SetData(Type, Object)

Parametry

Příklady

Poznámky

Viz také

Platí pro

SetData(String, Boolean, Object)

Parametry

Příklady

Poznámky

Viz také

Platí pro

Další materiály