DataObject.SetData Metódus

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Objektumot ad hozzá a DataObject.

Túlterhelések

Name	Description
SetData(String, Boolean, Object)	Hozzáadja a megadott objektumot a DataObject megadott formátumhoz, és jelzi, hogy az adatok átalakíthatók-e másik formátumba.
SetData(Type, Object)	A megadott objektumot DataObject a megadott típussal adja hozzá formátumként.
SetData(Object)	A megadott objektumot DataObject adatformátumként adja hozzá az objektumtípus használatával.
SetData(String, Object)	Hozzáadja a megadott objektumot a DataObject megadott formátumhoz.

SetData(String, Boolean, Object)

Forrás:

DataObject.cs

Hozzáadja a megadott objektumot a DataObject megadott formátumhoz, és jelzi, hogy az adatok átalakíthatók-e másik formátumba.

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

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

abstract member SetData : string * bool * obj -> unit
override this.SetData : string * bool * obj -> unit

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

Paraméterek

format

String

Az adatokhoz társított formátum. Előre DataFormats definiált formátumok megtekintése.

autoConvert

Boolean

trueaz adatok más formátumba való konvertálásának engedélyezése; egyéb esetben. false

data

Object

Az tárolandó adatok.

Megvalósítás

SetData(String, Boolean, Object)

Példák

Az alábbi példakód egy DataObject helyen tárolja az adatokat, és meghatározza, hogy az adatok csak natív formátumban kérhetők le.

Először létrejön egy új DataObject . A Unicode formátumú adatok tárolása a DataObjectkövetkező értékre autoConvert van állítva false: .

Ezután lekérdezi a DataObject rendelkezésre álló adatformátumok listáját. A rendszer csak a Unicode formátumot adja vissza, bár a Unicode-adatok szöveggé és más formátummá alakíthatók.

Ehhez a kódhoz létre kell textBox1 hozni.

private:
   void AddMyData4()
   {
      // Creates a new data object, and assigns it the component.
      DataObject^ myDataObject = gcnew DataObject;
      
      // Adds data to the DataObject, and specifies no format conversion.
      myDataObject->SetData( DataFormats::UnicodeText, false, "My Unicode data" );
      
      // Gets the data formats in the DataObject.
      array<String^>^ arrayOfFormats = myDataObject->GetFormats();
      
      // Prints the results.
      textBox1->Text = "The format(s) associated with the data are: \n";
      for ( int i = 0; i < arrayOfFormats->Length; i++ )
      {
         textBox1->Text = String::Concat( textBox1->Text, arrayOfFormats[ i ], "\n" );
      }
   }

private void AddMyData4() {
    // Creates a new data object, and assigns it the component.
    DataObject myDataObject = new DataObject();
 
    // Adds data to the DataObject, and specifies no format conversion.
    myDataObject.SetData(DataFormats.UnicodeText, false, "My Unicode data");
 
    // Gets the data formats in the DataObject.
    String[] arrayOfFormats = myDataObject.GetFormats();
 
    // Prints the results.
    textBox1.Text = "The format(s) associated with the data are: " + '\n';
    for(int i=0; i<arrayOfFormats.Length; i++)
       textBox1.Text += arrayOfFormats[i] + '\n';
 }

Private Sub AddMyData4()
    ' Creates a new data object, and assigns it the component.
    Dim myDataObject As New DataObject()
    
    ' Adds data to the DataObject, and specifies no format conversion.
    myDataObject.SetData(DataFormats.UnicodeText, False, "My Unicode data")
    
    ' Gets the data formats in the DataObject.
    Dim arrayOfFormats As String() = myDataObject.GetFormats()
    
    ' Prints the results.
    textBox1.Text = "The format(s) associated with the data are: " & ControlChars.Cr
    Dim i As Integer
    For i = 0 To arrayOfFormats.Length - 1
        textBox1.Text += arrayOfFormats(i) & ControlChars.Cr
    Next i
End Sub

Megjegyzések

Important

A metódus nem megbízható adatokkal való meghívása biztonsági kockázatot jelent. Ezt a metódust csak megbízható adatokkal hívhatja meg. További információ: Minden bemenet ellenőrzése.

Ha nem ismeri a célalkalmazás formátumát, ezzel a módszerrel több formátumban is tárolhatja az adatokat.

Lásd még

• GetData(String, Boolean)
• GetDataPresent(Type)
• GetFormats(Boolean)
• DataFormats

SetData(Type, Object)

Forrás:

DataObject.cs

A megadott objektumot DataObject a megadott típussal adja hozzá formátumként.

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

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

abstract member SetData : Type * obj -> unit
override this.SetData : Type * obj -> unit

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

Paraméterek

format

Type

Az Type adatokhoz társított formátumot jelképező formátum.

data

Object

Az tárolandó adatok.

Megvalósítás

SetData(Type, Object)

Példák

Az alábbi példakód adatformátumban DataObjectType tárolja az adatokat. Az adatok lekérése ezután az adatformátum megadásához használt hívással GetDataType történik. Az eredmény egy szövegdobozban jelenik meg.

Ehhez a kódhoz létre kell textBox1 hozni.

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

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

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

Megjegyzések

Important

A metódus nem megbízható adatokkal való meghívása biztonsági kockázatot jelent. Ezt a metódust csak megbízható adatokkal hívhatja meg. További információ: Minden bemenet ellenőrzése.

Ha nem ismeri a célalkalmazás formátumát, ezzel a módszerrel több formátumban is tárolhatja az adatokat.

Az ezzel a módszerrel tárolt adatok a lekéréskor kompatibilis formátummá alakíthatók.

Lásd még

• GetDataPresent(Type)
• GetData(String, Boolean)
• DataFormats
• GetFormats(Boolean)
• Type

SetData(Object)

Forrás:

DataObject.cs

A megadott objektumot DataObject adatformátumként adja hozzá az objektumtípus használatával.

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

public virtual void SetData(object? data);

abstract member SetData : obj -> unit
override this.SetData : obj -> unit

Public Overridable Sub SetData (data As Object)

Paraméterek

data

Object

Az tárolandó adatok.

Megvalósítás

SetData(Object)

Példák

Az alábbi példakód adatokat tárol egy DataObject. Először létrehoz egy újat DataObject , és egy összetevőt tárol benne. Ezután a rendszer az osztály megadásával kéri le az adatokat. Az eredmény egy szövegdobozban jelenik meg.

Ehhez a kódhoz létre kell textBox1 hozni.

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->Name,
           " is present in the DataObject" );
      }
      else
      {
         textBox1->Text = String::Concat( "Data of type ", myType->Name,
           " 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.GetType().Name + 
       " is present in the DataObject";
    else
       textBox1.Text = "Data of type " + myType.GetType().Name +
       " 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.GetType().Name & _
            " is present in the DataObject"
    Else
        textBox1.Text = "Data of type " & myType.GetType().Name & _
            " is not present in the DataObject"
    End If
End Sub

Megjegyzések

Important

A metódus nem megbízható adatokkal való meghívása biztonsági kockázatot jelent. Ezt a metódust csak megbízható adatokkal hívhatja meg. További információ: Minden bemenet ellenőrzése.

Ha nem ismeri a célalkalmazás formátumát, ezzel a módszerrel több formátumban is tárolhatja az adatokat. Az ezzel a módszerrel tárolt adatok a lekéréskor kompatibilis formátummá alakíthatók.

A SetData(Object) túlterhelés olyan formátumban tárolja az data értéket, amelyet a Object.GetType metódus meghívásával határoz meg. Ha data implementálja az ISerializable interfészt, ez a túlterhelés az értéket is formátumban Serializable tárolja.

Lásd még

• GetDataPresent(Type)
• GetData(String, Boolean)
• GetFormats(Boolean)
• System.Runtime.Serialization

SetData(String, Object)

Forrás:

DataObject.cs

Hozzáadja a megadott objektumot a DataObject megadott formátumhoz.

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

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

abstract member SetData : string * obj -> unit
override this.SetData : string * obj -> unit

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

Paraméterek

format

String

Az adatokhoz társított formátum. Előre DataFormats definiált formátumok megtekintése.

data

Object

Az tárolandó adatok.

Megvalósítás

SetData(String, Object)

Példák

Az alábbi példakód egy DataObjectunicode formátumban adja meg az adatokat.

Ezután a rendszer a szöveges formátum megadásával kéri le az adatokat, mivel az alapértelmezett az adatok konvertálása, ha a végső formátum kompatibilis. Az eredmény egy szövegdobozban jelenik meg.

Ehhez a kódhoz létre kell textBox1 hozni.

private:
   void AddMyData()
   {
      // Creates a new data object using a string and the text format.
      DataObject^ myDataObject = gcnew DataObject;
      
      // Stores a string, specifying the Unicode format.
      myDataObject->SetData( DataFormats::UnicodeText, "Text string" );
      
      // Retrieves the data by specifying Text.
      textBox1->Text = myDataObject->GetData( DataFormats::Text )->GetType()->Name;
   }

private void AddMyData() {
    // Creates a new data object using a string and the text format.
    DataObject myDataObject = new DataObject();
 
    // Stores a string, specifying the Unicode format.
    myDataObject.SetData(DataFormats.UnicodeText, "Text string");
 
    // Retrieves the data by specifying Text.
    textBox1.Text = myDataObject.GetData(DataFormats.Text).GetType().Name;
 }

Private Sub AddMyData()
    ' Creates a new data object using a string and the text format.
    Dim myDataObject As New DataObject()
    
    ' Stores a string, specifying the Unicode format.
    myDataObject.SetData(DataFormats.UnicodeText, "Text string")
    
    ' Retrieves the data by specifying Text.
    textBox1.Text = myDataObject.GetData(DataFormats.Text).GetType().Name
End Sub

Megjegyzések

Important

A metódus nem megbízható adatokkal való meghívása biztonsági kockázatot jelent. Ezt a metódust csak megbízható adatokkal hívhatja meg. További információ: Minden bemenet ellenőrzése.

Ha nem ismeri a célalkalmazás formátumát, ezzel a módszerrel több formátumban is tárolhatja az adatokat.

Az ezzel a módszerrel tárolt adatok a lekéréskor kompatibilis formátummá alakíthatók.

Lásd még

• GetData(String, Boolean)
• GetDataPresent(Type)
• GetFormats(Boolean)
• DataFormats