Lire en anglais

Partager via


DBNull.Value Champ

Définition

Représente l'instance unique de la classe DBNull.

C#
public static readonly DBNull Value;

Valeur de champ

Exemples

L’exemple suivant appelle la DBNull.Value.Equals méthode pour déterminer si un champ de base de données dans une base de données de contacts a une valeur valide. Si c’est le cas, la valeur du champ est ajoutée à la sortie de chaîne dans une étiquette.

C#
private void OutputLabels(DataTable dt)
{
   string label;

   // Iterate rows of table
   foreach (DataRow row in dt.Rows)
   {
      int labelLen;
      label = String.Empty;
      label += AddFieldValue(label, row, "Title");
      label += AddFieldValue(label, row, "FirstName");
      label += AddFieldValue(label, row, "MiddleInitial");
      label += AddFieldValue(label, row, "LastName");
      label += AddFieldValue(label, row, "Suffix");
      label += "\n";
      label += AddFieldValue(label, row, "Address1");
      label += AddFieldValue(label, row, "AptNo");
      label += "\n";
      labelLen = label.Length;
      label += AddFieldValue(label, row, "Address2");
      if (label.Length != labelLen)
         label += "\n";
      label += AddFieldValue(label, row, "City");
      label += AddFieldValue(label, row, "State");
      label += AddFieldValue(label, row, "Zip");
      Console.WriteLine(label);
      Console.WriteLine();
   }
}

private string AddFieldValue(string label, DataRow row,
                             string fieldName)
{
   if (!DBNull.Value.Equals(row[fieldName]))
      return (string) row[fieldName] + " ";
   else
      return String.Empty;
}

Remarques

DBNullest une classe singleton, ce qui signifie que seule cette instance de cette classe peut exister.

Si un champ de base de données contient des données manquantes, vous pouvez utiliser la DBNull.Value propriété pour affecter explicitement une valeur d’objet DBNull au champ. Toutefois, la plupart des fournisseurs de données le font automatiquement.

Pour évaluer les champs de base de données afin de déterminer si leurs valeurs sont DBNull, vous pouvez passer la valeur de champ à la DBNull.Value.Equals méthode . Toutefois, cette méthode est rarement utilisée, car il existe plusieurs autres façons d’évaluer un champ de base de données pour les données manquantes. Il s’agit notamment de la fonction Visual Basic IsDBNull , de la Convert.IsDBNull méthode, de la DataTableReader.IsDBNull méthode, de la IDataRecord.IsDBNull méthode et de plusieurs autres méthodes.

S’applique à

Produit Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1
UWP 10.0