DataFormats Klasse

Definition

Stellt Clipboard-Formatnamen bereit, die static und vordefiniert sind.Provides static, predefined Clipboard format names. Mit diesen können Sie das Format von Daten festlegen, die Sie in IDataObject speichern.Use them to identify the format of data that you store in an IDataObject.

public ref class DataFormats
public class DataFormats
type DataFormats = class
Public Class DataFormats
Vererbung
DataFormats

Beispiele

Im folgenden Codebeispiel wird ein neues Datenformat namens myFormaterstellt.The following code example creates a new data format named myFormat. Der Code erstellt dann ein-MyNewObject, das in einem DataObjectgespeichert wird.The code then creates a MyNewObject which it stores in a DataObject. Der DataObject wird in den Clipboardkopiert.The DataObject is copied to the Clipboard.

Als nächstes wird der DataObject vom Clipboard abgerufen, und die MyNewObject wird wieder hergestellt.Next, the DataObject is retrieved from the Clipboard and the MyNewObject is recovered. Der Wert des MyNewObject wird in einem Textfeld gedruckt.The value of the MyNewObject is printed in a text box. Dieser Code erfordert, dass textBox1 erstellt und in einem Formular abgelegt wurde.This code requires that textBox1 has been created and placed on a form.

#using <System.dll>
#using <System.Drawing.dll>
#using <System.Windows.Forms.dll>

using namespace System;
using namespace System::Windows::Forms;

// Creates a new type.

[Serializable]
public ref class MyNewObject: public Object
{
private:
   String^ myValue;

public:

   // Creates a default constructor for the class.
   MyNewObject()
   {
      myValue = "This is the value of the class";
   }


   property String^ MyObjectValue 
   {

      // Creates a property to retrieve or set the value.
      String^ get()
      {
         return myValue;
      }

      void set( String^ value )
      {
         myValue = value;
      }

   }

};

public ref class MyClass: public Form
{
protected:
   TextBox^ textBox1;

public:
   void MyClipboardMethod()
   {
      
      // Creates a new data format.
      DataFormats::Format^ myFormat = DataFormats::GetFormat( "myFormat" );
      
      /* Creates a new object and stores it in a DataObject using myFormat 
               * as the type of format. */
      MyNewObject^ myObject = gcnew MyNewObject;
      DataObject^ myDataObject = gcnew DataObject( myFormat->Name,myObject );
      
      // Copies myObject into the clipboard.
      Clipboard::SetDataObject( myDataObject );
      
      // Performs some processing steps.
      // Retrieves the data from the clipboard.
      IDataObject^ myRetrievedObject = Clipboard::GetDataObject();
      
      // Converts the IDataObject type to MyNewObject type. 
      MyNewObject^ myDereferencedObject = dynamic_cast<MyNewObject^>(myRetrievedObject->GetData( myFormat->Name ));
      
      // Prints the value of the Object in a textBox.
      textBox1->Text = myDereferencedObject->MyObjectValue;
   }

};

using System;
using System.Windows.Forms;

public class MyClass : Form {
    protected TextBox textBox1;
    
    public void MyClipboardMethod() {
       // Creates a new data format.
       DataFormats.Format myFormat = DataFormats.GetFormat("myFormat");
       
       /* Creates a new object and stores it in a DataObject using myFormat 
        * as the type of format. */
       MyNewObject myObject = new MyNewObject();
       DataObject myDataObject = new DataObject(myFormat.Name, myObject);
 
       // Copies myObject into the clipboard.
       Clipboard.SetDataObject(myDataObject);
 
       // Performs some processing steps.
 
       // Retrieves the data from the clipboard.
       IDataObject myRetrievedObject = Clipboard.GetDataObject();
 
       // Converts the IDataObject type to MyNewObject type. 
       MyNewObject myDereferencedObject = (MyNewObject)myRetrievedObject.GetData(myFormat.Name);
 
       // Prints the value of the Object in a textBox.
       textBox1.Text = myDereferencedObject.MyObjectValue;
    }
 }
 
 // Creates a new type.
 [Serializable]
 public class MyNewObject : Object {
    private string myValue;
 
    // Creates a default constructor for the class.
    public MyNewObject() {
       myValue = "This is the value of the class";
    }
 
    // Creates a property to retrieve or set the value.
    public string MyObjectValue {
       get {
          return myValue;
       }
       set {
          myValue = value;
       }
    }
 }

 
Option Explicit
Option Strict

Imports System.Windows.Forms

Public Class MyClass1
    Inherits Form
    Private textBox1 As TextBox

    Public Sub MyClipboardMethod()
        ' Creates a new data format.
        Dim myFormat As DataFormats.Format = _
            DataFormats.GetFormat("myFormat")
        
        ' Creates a new object and store it in a DataObject using myFormat 
        ' as the type of format. 
        Dim myObject As New MyNewObject()
        Dim myDataObject As New DataObject(myFormat.Name, myObject)
        
        ' Copies myObject into the clipboard.
        Clipboard.SetDataObject(myDataObject)
        
        ' Performs some processing steps.
        ' Retrieves the data from the clipboard.
        Dim myRetrievedObject As IDataObject = Clipboard.GetDataObject()
        
        ' Converts the IDataObject type to MyNewObject type. 
        Dim myDereferencedObject As MyNewObject = _
            CType(myRetrievedObject.GetData(myFormat.Name), MyNewObject)
        
        ' Print the value of the Object in a textBox.
        textBox1.Text = myDereferencedObject.MyObjectValue
    End Sub
End Class


' Creates a new type.
<Serializable()> Public Class MyNewObject
    Inherits Object
    Private myValue As String
    
    
    ' Creates a default constructor for the class.
    Public Sub New()
        myValue = "This is the value of the class"
    End Sub
    
    ' Creates a property to retrieve or set the value.
    
    Public Property MyObjectValue() As String
        Get
            Return myValue
        End Get
        Set
            myValue = value
        End Set
    End Property
End Class

Hinweise

Die Klassen IDataObject und DataObject verwenden auch die Liste static Format, um den Datentyp zu bestimmen, der aus dem System Clipboardabgerufen wird, oder der in einem Drag & Drop-Vorgang übertragen wird.The IDataObject and DataObject classes also use the static format list to determine the type of data that is retrieved from the system Clipboard, or that is transferred in a drag-and-drop operation.

Die GetFormat-Methode ermöglicht Ihnen Folgendes:The GetFormat method allows you to:

  • Ein vordefiniertes DataFormats.Format Objekt für einen Format Namen oder eine ID-Nummer erhalten.Get a predefined DataFormats.Format object for a format name or ID number.

  • Fügen Sie der static Liste in dieser Klasse ein neues Paar aus Format Name/ID-Nummer hinzu, und registrieren Sie das Format bei der Windows-Registrierung als Clipboard Format, wenn Sie den Format Namen übergeben.Add a new format name/ID number pair to the static list in this class, and to register the format with the Windows registry as a Clipboard format when you pass it the format name.

Sie können die Id Nummer oder das Format Name aus der entsprechenden Eigenschaft in der DataFormats.Format Instanz erhalten.You can get the Id number or format Name from the appropriate property in the DataFormats.Format instance.

Felder

Bitmap

Gibt ein Windows-Bitmap-Format an.Specifies a Windows bitmap format. Dieses static-Feld ist schreibgeschützt.This static field is read-only.

CommaSeparatedValue

Gibt ein CSV-Format (Comma-Separated Value) an, ein verbreitetes Austauschformat, das von Tabellenkalkulationsprogrammen verwendet wird.Specifies a comma-separated value (CSV) format, which is a common interchange format used by spreadsheets. Dieses Format wird nicht direkt von Windows Forms verwendet.This format is not used directly by Windows Forms. Dieses static-Feld ist schreibgeschützt.This static field is read-only.

Dib

Gibt das DIB-Format (Device Independent Bitmap) von Windows an.Specifies the Windows device-independent bitmap (DIB) format. Dieses static-Feld ist schreibgeschützt.This static field is read-only.

Dif

Gibt das Windows-Datenaustauschformat DIF an (Data Interchange Format) an, das Windows Forms nicht direkt verwendet.Specifies the Windows Data Interchange Format (DIF), which Windows Forms does not directly use. Dieses static-Feld ist schreibgeschützt.This static field is read-only.

EnhancedMetafile

Gibt das Windows-Format Erweiterte Metadatei an.Specifies the Windows enhanced metafile format. Dieses static-Feld ist schreibgeschützt.This static field is read-only.

FileDrop

Gibt das Dateiablageformat von Windows an, das Windows Forms nicht direkt verwendet.Specifies the Windows file drop format, which Windows Forms does not directly use. Dieses static-Feld ist schreibgeschützt.This static field is read-only.

Html

Gibt Text im HTML-Zwischenablageformat an.Specifies text in the HTML Clipboard format. Dieses static-Feld ist schreibgeschützt.This static field is read-only.

Locale

Gibt das Windows-Kulturformat an, das Windows Forms nicht direkt verwendet.Specifies the Windows culture format, which Windows Forms does not directly use. Dieses static-Feld ist schreibgeschützt.This static field is read-only.

MetafilePict

Gibt das Metadateiformat von Windows an, das Windows Forms nicht direkt verwendet.Specifies the Windows metafile format, which Windows Forms does not directly use. Dieses static-Feld ist schreibgeschützt.This static field is read-only.

OemText

Gibt das OEM-Standardtextformat (Original Equipment Manufacturer) von Windows an.Specifies the standard Windows original equipment manufacturer (OEM) text format. Dieses static-Feld ist schreibgeschützt.This static field is read-only.

Palette

Gibt das Palettenformat von Windows an.Specifies the Windows palette format. Dieses static-Feld ist schreibgeschützt.This static field is read-only.

PenData

Gibt das Pen-Datenformat von Windows an, das Stiftstriche für Handschrift-Software enthält. Windows Forms verwendet dieses Format nicht.Specifies the Windows pen data format, which consists of pen strokes for handwriting software; Windows Forms does not use this format. Dieses static-Feld ist schreibgeschützt.This static field is read-only.

Riff

Gibt das RIFF-Audioformat (Resource Interchange File Format) an, das von Windows Forms nicht direkt verwendet wird.Specifies the Resource Interchange File Format (RIFF) audio format, which Windows Forms does not directly use. Dieses static-Feld ist schreibgeschützt.This static field is read-only.

Rtf

Gibt Text an, der aus RTF-Daten (Rich Text Format) besteht.Specifies text consisting of Rich Text Format (RTF) data. Dieses static-Feld ist schreibgeschützt.This static field is read-only.

Serializable

Gibt ein Format an, das beliebige Windows Forms-Objekte kapselt.Specifies a format that encapsulates any type of Windows Forms object. Dieses static-Feld ist schreibgeschützt.This static field is read-only.

StringFormat

Gibt das Format der Zeichenfolgenklassen in Windows Forms an, in dem Zeichenfolgenobjekte von Windows Forms gespeichert werden.Specifies the Windows Forms string class format, which Windows Forms uses to store string objects. Dieses static-Feld ist schreibgeschützt.This static field is read-only.

SymbolicLink

Gibt das Format für symbolische Links in Windows an, das Windows Forms nicht direkt verwendet.Specifies the Windows symbolic link format, which Windows Forms does not directly use. Dieses static-Feld ist schreibgeschützt.This static field is read-only.

Text

Gibt das standardmäßige ANSI-Textformat an.Specifies the standard ANSI text format. Dieses static-Feld ist schreibgeschützt.This static field is read-only.

Tiff

Gibt das TIFF-Format (Tagged Image File Format) an, das von Windows Forms nicht direkt verwendet wird.Specifies the Tagged Image File Format (TIFF), which Windows Forms does not directly use. Dieses static-Feld ist schreibgeschützt.This static field is read-only.

UnicodeText

Gibt das standardmäßige Unicode-Textformat von Windows an.Specifies the standard Windows Unicode text format. Dieses static-Feld ist schreibgeschützt.This static field is read-only.

WaveAudio

Gibt das Wave-Audio-Format an, das Windows Forms nicht direkt verwendet.Specifies the wave audio format, which Windows Forms does not directly use. Dieses static-Feld ist schreibgeschützt.This static field is read-only.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetFormat(Int32)

Gibt ein DataFormats.Format der Windows-Zwischenablage mit der numerischen ID und dem entsprechenden Namen zurück.Returns a DataFormats.Format with the Windows Clipboard numeric ID and name for the specified ID.

GetFormat(String)

Gibt ein DataFormats.Format der Windows-Zwischenablage mit der numerischen ID und dem Namen für das angegebene Format zurück.Returns a DataFormats.Format with the Windows Clipboard numeric ID and name for the specified format.

GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Gilt für:

Siehe auch