Markieren Sie das Kontrollkästchen Englisch, um die englische Version dieses Artikels anzuzeigen. Sie können den englischen Text auch in einem Popup-Fenster einblenden, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch
Diese Dokumentation wurde archiviert und wird nicht länger gepflegt.

Nullable<T>-Struktur

Stellt ein Objekt dar, dessen zugrunde liegender Typ ein Werttyp ist und das auch null wie einen Verweistyp zugewiesen werden kann.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

[SerializableAttribute]
public struct Nullable<T>
where T : struct, new()

Typparameter

T

Der zugrunde liegende Werttyp des generischen Nullable<T>-Typs.

Der Nullable<T>-Typ macht die folgenden Member verfügbar.

  NameBeschreibung
Öffentliche MethodeUnterstützt von XNA Frameworkb3h38hb0.PortableClassLibrary(de-de,VS.100).gifNullable<T>Initialisiert eine neue Instanz der Nullable<T>-Struktur mit dem angegebenen Wert.
Zum Seitenanfang

  NameBeschreibung
Öffentliche EigenschaftUnterstützt von XNA Frameworkb3h38hb0.PortableClassLibrary(de-de,VS.100).gifHasValueRuft einen Wert ab, der angibt, ob das aktuelle Nullable<T>-Objekt einen Wert hat.
Öffentliche EigenschaftUnterstützt von XNA Frameworkb3h38hb0.PortableClassLibrary(de-de,VS.100).gifValueRuft den Wert des aktuellen Nullable<T>-Werts ab.
Zum Seitenanfang

  NameBeschreibung
Öffentliche MethodeUnterstützt von XNA Frameworkb3h38hb0.PortableClassLibrary(de-de,VS.100).gifEqualsGibt an, ob das aktuelle Nullable<T>-Objekt einem angegebenen Objekt entspricht. (Überschreibt ValueType.Equals(Object).)
Geschützte MethodeUnterstützt von XNA Frameworkb3h38hb0.PortableClassLibrary(de-de,VS.100).gifFinalize Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
Öffentliche MethodeUnterstützt von XNA Frameworkb3h38hb0.PortableClassLibrary(de-de,VS.100).gifGetHashCodeRuft den Hashcode des Objekts ab, das von der Value-Eigenschaft zurückgegeben wird. (Überschreibt ValueType.GetHashCode().)
Öffentliche MethodeUnterstützt von XNA Frameworkb3h38hb0.PortableClassLibrary(de-de,VS.100).gifGetTypeRuft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Öffentliche MethodeUnterstützt von XNA Frameworkb3h38hb0.PortableClassLibrary(de-de,VS.100).gifGetValueOrDefault()Ruft den Wert des aktuellen Nullable<T>-Objekts oder den Standardwert des Objekts ab.
Öffentliche MethodeUnterstützt von XNA Frameworkb3h38hb0.PortableClassLibrary(de-de,VS.100).gifGetValueOrDefault(T)Ruft den Wert des aktuellen Nullable<T>-Objekts oder den angegebenen Standardwert ab.
Geschützte MethodeUnterstützt von XNA Frameworkb3h38hb0.PortableClassLibrary(de-de,VS.100).gifMemberwiseCloneErstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Öffentliche MethodeUnterstützt von XNA Frameworkb3h38hb0.PortableClassLibrary(de-de,VS.100).gifToStringGibt die Textdarstellung des Werts des aktuellen Nullable<T>-Objekts zurück. (Überschreibt ValueType.ToString().)
Zum Seitenanfang

  NameBeschreibung
Öffentlicher OperatorStatischer MemberUnterstützt von XNA Frameworkb3h38hb0.PortableClassLibrary(de-de,VS.100).gifExplicit(Nullable<T> to T)Gibt den Wert eines angegebenen Nullable<T>-Werts zurück.
Öffentlicher OperatorStatischer MemberUnterstützt von XNA Frameworkb3h38hb0.PortableClassLibrary(de-de,VS.100).gifImplicit(T to Nullable<T>)Erstellt ein neues Nullable<T>-Objekt, das mit einem angegebenen Wert initialisiert wurde.
Zum Seitenanfang

NULL-Werte sind zulässig für Typen, denen entweder ein Wert oder null zugewiesen werden kann, das heißt für Typen, denen nicht notwendigerweise ein Wert zugewiesen werden muss. Daher drückt ein Typ, für den NULL-Werte zulässig sind, entweder einen Wert aus, oder er drückt aus, dass kein Wert vorhanden ist. Beispielsweise sind für einen Verweistyp wie String NULL-Werte zulässig, für einen Werttyp wie Int32 dagegen nicht. Für einen Werttyp sind NULL-Werte unzulässig, weil er über ausreichend Kapazität verfügt, um nur die Werte auszudrücken, die diesem Typ entsprechen. Ein Werttyp verfügt nicht über die zusätzliche Kapazität, die erforderlich ist, um einen NULL-Wert auszudrücken.

Die Nullable<T>-Struktur unterstützt die Verwendung von nur einem Werttyp als einen Typ, für den NULL-Werte zulässig sind, da für Verweistypen per Definition NULL-Werte zulässig sind.

Die Nullable-Klasse unterstützt die Nullable<T>-Struktur. Die Nullable-Klasse unterstützt das Abrufen des zugrunde liegenden Typs eines Typs, für den NULL-Werte zulässig sind, und Vergleiche und Gleichheitsoperationen mit Paaren von Typen, für die NULL-Werte zulässig sind und deren zugrunde liegender Werttyp keine generischen Vergleiche oder Gleichheitsoperationen unterstützt.

Szenario

Verwenden Sie Typen, die NULL-Werte zulassen, um Sachen darzustellen, die situationsabhängig entweder vorhanden oder nicht vorhanden sind. Zum Beispiel ist ein optionales Attribut, das NULL-Werte zulässt, nicht in allen HTML-Tags vorhanden, und eine Spalte, die NULL-Werte zulässt, wird nicht in jeder Zeile einer Tabelle angezeigt.

Sie können das Attribut oder die Spalte als Feld in einer Klasse darstellen, und Sie können das Feld als Werttyp definieren. Das Feld kann alle gültigen Werte für das Attribut oder die Spalte enthalten, nicht jedoch einen zusätzlichen Wert, d. h., das Attribut oder die Spalte ist nicht vorhanden. Definieren Sie in diesem Fall, dass das Feld kein Werttyp ist, sondern ein Feld, für das NULL-Werte zulässig sind.

Wesentliche Eigenschaften

Die zwei wesentlichen Member der Nullable<T>-Struktur sind die HasValue-Eigenschaft und die Value-Eigenschaft. Wenn die HasValue-Eigenschaft für ein Nullable<T>-Objekt true ist, kann der Wert des Objekts mit der Value-Eigenschaft aufgerufen werden. Wenn die HasValue-Eigenschaft false ist, ist der Wert des Objekts nicht definiert, und beim Versuch, die Value-Eigenschaft aufzurufen, wird eine InvalidOperationException ausgelöst.

Boxing und Unboxing

Wenn ein Typ, für den NULL-Werte zulässig sind, geschachtelt wird, schachtelt die Common Language Runtime den zugrunde liegenden Wert des Nullable<T>-Objekts, aber nicht das Nullable<T>-Objekt selbst. Das heißt, wenn die HasValue-Eigenschaft true ist, wird der Inhalt der Value-Eigenschaft geschachtelt. Wenn der zugrunde liegende Wert eines Typs, für den NULL-Werte zulässig sind, mittels Unboxing konvertiert wird, erstellt die Common Language Runtime eine neue Nullable<T>-Struktur, die mit dem zugrunde liegenden Wert initialisiert wird.

Wenn die HasValue-Eigenschaft false ist für einen Typ, für den Nullwerte zulässig sind, dann ist das Ergebnis eines Boxingvorgangs null. Wenn also an eine Methode ein geschachtelter Typ übergeben wird, für den Nullwerte zulässig sind, muss die Methode, die ein Objektargument erwartet, auch den Fall berücksichtigen, in dem das Argument null ist. Wenn beim Unboxing null in einen Typ geschrieben wird, für den Nullwerte zulässig sind, erstellt die Common Language Runtime eine neue Nullable<T>-Struktur und initialisiert deren HasValue-Eigenschaft auf false.

Im folgenden Codebeispiel werden drei Zeilen einer Tabelle in der Microsoft Pubs-Beispieldatenbank definiert. Die Tabelle enthält zwei Spalten, für die keine NULL-Werte zulässig sind, und zwei Spalten, für die NULL-Werte zulässig sind.


// This code example demonstrates the Nullable<T> class.
// The code example defines a database table in which two columns 
// are nullable. In the application, an array of rows is created 
// and initialized. The table rows could subsequently be 
// written to a database.

using System;

class Sample 
{
// Define the "titleAuthor" table of the Microsoft "pubs" database. 
    public struct titleAuthor 
    {
    // Author ID; format ###-##-####
    public string au_id;
    // Title ID; format AA####
    public string title_id;
    // Author ORD is nullable.
    public short? au_ord;
    // Royalty Percent is nullable.
    public int? royaltyper;
    }

    public static void Main() 
    {
// Declare and initialize the titleAuthor array.
    titleAuthor[] ta = new titleAuthor[3];
    ta[0].au_id = "712-32-1176";
    ta[0].title_id = "PS3333";
    ta[0].au_ord = 1;
    ta[0].royaltyper = 100;

    ta[1].au_id = "213-46-8915";
    ta[1].title_id = "BU1032";
    ta[1].au_ord = null;
    ta[1].royaltyper = null;

    ta[2].au_id = "672-71-3249";
    ta[2].title_id = "TC7777";
    ta[2].au_ord = null;
    ta[2].royaltyper = 40;

// Display the values of the titleAuthor array elements, and 
// display a legend.
    Display("Title Authors Table", ta);
    Console.WriteLine("Legend:");
    Console.WriteLine("An Author ORD of -1 means no value is defined.");
    Console.WriteLine("A Royalty % of 0 means no value is defined.");
    }

// Display the values of the titleAuthor array elements.
    public static void Display(string dspTitle, 
                               titleAuthor[] dspAllTitleAuthors)
    {
    Console.WriteLine("*** {0} ***", dspTitle);
    foreach (titleAuthor dspTA in dspAllTitleAuthors)
       {
       Console.WriteLine("Author ID ... {0}", dspTA.au_id);
       Console.WriteLine("Title ID .... {0}", dspTA.title_id);
       Console.WriteLine("Author ORD .. {0}", dspTA.au_ord ?? -1);
       Console.WriteLine("Royalty % ... {0}", dspTA.royaltyper ?? 0);
       Console.WriteLine();       
       }
    }
}

/*
This code example produces the following results:

*** Title Authors Table ***
Author ID ... 712-32-1176
Title ID .... PS3333
Author ORD .. 1
Royalty % ... 100

Author ID ... 213-46-8915
Title ID .... BU1032
Author ORD .. -1
Royalty % ... 0

Author ID ... 672-71-3249
Title ID .... TC7777
Author ORD .. -1
Royalty % ... 40

Legend:
An Author ORD of -1 means no value is defined.
A Royalty % of 0 means no value is defined.

*/


.NET Framework

Unterstützt in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Unterstützt in:

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Anzeigen: