フッターコンテンツにスキップ
.NETヘルプ

C#のヌル可能型(開発者にとっての仕組み)

C#を使用する場合、特に参照型ではnull値を扱う必要があることがよくあります。C#のnullable型は、値型に対して未定義または存在しない値を表現する方法を提供します。このガイドでは、C#のnullable型の基本、実際の使用法、およびさまざまなシナリオでの動作について説明します。 記事の後半では<IronPDFも探ります。

Nullable Types in C

C#ではデフォルトで値型(例:int、bool、DateTime)にnull値を割り当てることはできません。 この制限に対処するために、C#はnullable値型を導入し、値型にnullを割り当てることができます。nullable型は、有効な値が欠如している場合に特に役立ちます。

Nullable型の宣言

C#でnullable型を宣言するには、次の構文を使用します。

// Declare a nullable integer
int? nullableInt = null;
// Declare a nullable integer
int? nullableInt = null;
$vbLabelText   $csharpLabel

ここで、int?Nullable<int> の省略形です。 nullableInt 変数は int 値または null のいずれかを保持できます。

nullを確認する

null 許容型変数に値があるかどうかを確認するには、HasValue プロパティを使用するか、次に示すように変数を null と直接比較します。

if (nullableInt.HasValue)
{
    // If nullableInt has a value, print it
    Console.WriteLine("Value: " + nullableInt.Value);
}
else
{
    // If nullableInt does not have a value, print a message
    Console.WriteLine("No value assigned.");
}
if (nullableInt.HasValue)
{
    // If nullableInt has a value, print it
    Console.WriteLine("Value: " + nullableInt.Value);
}
else
{
    // If nullableInt does not have a value, print a message
    Console.WriteLine("No value assigned.");
}
$vbLabelText   $csharpLabel

また、nullable型がnullの場合にデフォルト値を提供するために、null合体演算子(??)を使用することもできます。

// Assign 0 if nullableInt is null
int result = nullableInt ?? 0;
Console.WriteLine("Result: " + result);
// Assign 0 if nullableInt is null
int result = nullableInt ?? 0;
Console.WriteLine("Result: " + result);
$vbLabelText   $csharpLabel

nullableInt が null の場合、result にはデフォルト値の 0 が割り当てられます。

Nullable値型とNullable参照型

C#では、値型(int、bool、doubleなど)と参照型(string、objectなど)は異なります。 nullable値型は値型にnullを表現することを許可し、nullable参照型はデフォルトで参照型を非nullableにすることで、null参照例外のリスクを軽減します。

Nullable値型

nullable値型は、値型にnull値を取らせることを可能にします。 null 許容値型を宣言するには、データ型に疑問符 ? を追加します。

// Declare a nullable double
double? nullableDouble = null;
// Declare a nullable double
double? nullableDouble = null;
$vbLabelText   $csharpLabel

この例では、nullableDouble は double 値または null を保持できます。

Nullable参照型

Null許容参照型はC# 8.0で導入されました。Null許容参照型は、プロジェクトレベルで有効化するか、コードファイルの先頭に?を使用して参照型を明示的にNull許容としてマークする必要があります。これにより、Null参照によって発生する可能性のある実行時例外を回避できます。

#nullable enable
// Declare a nullable string
string? nullableString = null;
#nullable enable
// Declare a nullable string
string? nullableString = null;
$vbLabelText   $csharpLabel

ここで、nullableString は null にすることができます。 ? を使用せずに null 非許容参照型を宣言すると、コンパイラは潜在的な null 割り当てを検出すると警告を生成します。

Nullable参照型の有効化

プロジェクト内で null 許容参照型をグローバルに有効にするには、.csproj ファイルに次の行を追加します。

<Nullable>enable</Nullable>
<Nullable>enable</Nullable>
XML

一旦有効化されると、コンパイラはデフォルトで参照型を非nullableとして扱います。 この機能は、実行時ではなくコンパイル時にnull参照の問題を検出するのに特に便利です。

実用的な例

nullable型の理解を深めるためにいくつかの実用的な例を見てみましょう。

例1: 値型とNullable型

この例では、intを使用したnullable型を使用します。

class Program
{
    static void Main(string[] args)
    {
        int? nullableInt = null;
        // Use null coalescing operator to assign a default value
        int b = nullableInt ?? 10;
        Console.WriteLine("b: " + b);
        if (nullableInt.HasValue)
        {
            // nullableInt has a value
            Console.WriteLine("nullableInt has value: " + nullableInt.Value);
        }
        else
        {
            // nullableInt is null
            Console.WriteLine("nullableInt is null");
        }
    }
}
class Program
{
    static void Main(string[] args)
    {
        int? nullableInt = null;
        // Use null coalescing operator to assign a default value
        int b = nullableInt ?? 10;
        Console.WriteLine("b: " + b);
        if (nullableInt.HasValue)
        {
            // nullableInt has a value
            Console.WriteLine("nullableInt has value: " + nullableInt.Value);
        }
        else
        {
            // nullableInt is null
            Console.WriteLine("nullableInt is null");
        }
    }
}
$vbLabelText   $csharpLabel

ここで、nullableInt は int の null 許容型変数です。 nullableInt が null の場合、b は null 合体演算子により値 10 を取得します。 それ以外の場合、bnullableInt の値を取ります。

例2: Nullable参照型

次に、nullable参照型がどのように機能するか見てみましょう。

#nullable enable
class Program
{
    static void Main()
    {
        string? nullableString = null;
        string nonNullableString = "Hello";
        // Use null coalescing operator to provide a default value for length
        Console.WriteLine(nullableString?.Length ?? 0);
        Console.WriteLine(nonNullableString.Length);
    }
}
#nullable enable
class Program
{
    static void Main()
    {
        string? nullableString = null;
        string nonNullableString = "Hello";
        // Use null coalescing operator to provide a default value for length
        Console.WriteLine(nullableString?.Length ?? 0);
        Console.WriteLine(nonNullableString.Length);
    }
}
$vbLabelText   $csharpLabel

上記のコードでは、nullableString は null になる可能性があり、null 合体演算子により、null の場合は文字列の長さがデフォルトで 0 になることが保証されます。

例3: ネストされたNullable型

C#はネストされたnullable型を宣言することを許可しています。例:

// Redundant, but syntactically valid
int? nestedNullableInt = null;
// Redundant, but syntactically valid
int? nestedNullableInt = null;
$vbLabelText   $csharpLabel

ネストされたnullable型は冗長に見えるかもしれませんが、C#では文法的に有効です。 ただし、実際には、ネストされたnullable型は追加の機能を提供せず、滅多に使用されません。

Null合体演算子(??)

null合体演算子(??)は、nullable型がnullの場合にデフォルト値を提供するために頻繁に使用されます。 この演算子は、明示的なif-elseチェックを避けつつコードを簡潔にします。

int? nullableValue = null;
// Assign -1 if nullableValue is null
int defaultValue = nullableValue ?? -1;
int? nullableValue = null;
// Assign -1 if nullableValue is null
int defaultValue = nullableValue ?? -1;
$vbLabelText   $csharpLabel

この例では、nullableValue が null の場合、defaultValue には -1 が割り当てられます。それ以外の場合、defaultValue には nullableValue の値が設定されます。

コンパイル時エラーとNullable型

nullable参照型が有効化された状態では、C#はコンパイル中に潜在的なnull代入の問題を検出すると警告やエラーを生成します。 これらのコンパイル時エラーは、問題を早期に発見し、コードをより堅牢にします。

次の例を考えてみましょう。

string? nullableString = null;
// This will produce a compiler warning because nullableString may be null
string nonNullableString = nullableString;
string? nullableString = null;
// This will produce a compiler warning because nullableString may be null
string nonNullableString = nullableString;
$vbLabelText   $csharpLabel

この場合、nullableStringnonNullableString に割り当てると、nullableString が null になる可能性があり、これを null 非許容型に割り当てると実行時例外が発生する可能性があるため、コンパイラ警告が生成されます。

IronPDFでのNullable型の使用

C# の Null 許容型 (開発者向けの仕組み): 図 1 - IronPDF: C# PDF ライブラリ

IronPDFは、開発者が.NETアプリケーションから直接PDFファイルを作成、編集、および操作するのに役立つC# PDFライブラリです。 HTMLをPDFに変換したり、レポートを生成したり、複雑な文書構造を扱ったりすることができます。

nullable型は、特に不完全な財務データを持つ会計士のためにPDFを生成する場合など、動的レポート生成シナリオにおいて役立ちます。 nullable型を使用することで、オプションのフィールドを管理し、例外を回避し、デフォルト値を提供できます。

using IronPdf;
class Program
{
    static void Main(string[] args)
    {
        int? optionalIncome = null;  // Nullable type for optional income
        string? clientName = "Iron Dev";  // Nullable reference type for client name
        var renderer = new ChromePdfRenderer();
        string htmlContent = $@"
            <h1>Financial Report</h1>
            <p>Client Name: {clientName ?? "Unknown"}</p>
            <p>Income: {optionalIncome?.ToString() ?? "Data not available"}</p>";
        // Render the HTML to a PDF
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        // Save the PDF to disk
        pdf.SaveAs("FinancialReport.pdf");
        Console.WriteLine("PDF Generated Successfully.");
    }
}
using IronPdf;
class Program
{
    static void Main(string[] args)
    {
        int? optionalIncome = null;  // Nullable type for optional income
        string? clientName = "Iron Dev";  // Nullable reference type for client name
        var renderer = new ChromePdfRenderer();
        string htmlContent = $@"
            <h1>Financial Report</h1>
            <p>Client Name: {clientName ?? "Unknown"}</p>
            <p>Income: {optionalIncome?.ToString() ?? "Data not available"}</p>";
        // Render the HTML to a PDF
        var pdf = renderer.RenderHtmlAsPdf(htmlContent);
        // Save the PDF to disk
        pdf.SaveAs("FinancialReport.pdf");
        Console.WriteLine("PDF Generated Successfully.");
    }
}
$vbLabelText   $csharpLabel

C# の Null 許容型 (開発者向けの仕組み): 図 2 - コード出力例

このコードでは、欠損データを安全に処理するために、null 許容型 (int? および string?) が使用されています。 null合体演算子(??)は、データが欠けている場合にデフォルト値がPDFに使用されることを保証します。

結論

C# の Null 許容型 (開発者向けの仕組み): 図 3 - IronPDF のライセンス ページ

C#におけるnullable型は、値型および参照型に対するnull値の処理において強力なツールです。nullable型を使用することで、null参照例外を回避し、コードの堅牢性を向上させることができます。 新しいプロジェクトではnullable参照型を有効にしてコンパイル時エラーチェックの恩恵を受け、nullable型を扱う際にはnull合体演算子(??)を使用してコードを簡素化することを心がけましょう。

IronPDFは無料トライアルを提供しており、実際に利用して機能を確認する機会を提供します。 With no cost upfront, you can test the waters and see how it fits into your development process. 先に進む準備ができたら、ライセンスは $799 から始まります。

よくある質問

nullable型は動的なPDF生成でどのように利用できますか?

nullable型は、IronPDFのようなライブラリを使用して、オプションフィールドを安全に表現することで、動的なPDF生成において重要です。これにより、データが欠落している場合も適切に処理され、必要に応じてデフォルト値が提供されます。

C#でnullable型を宣言するための文法は何ですか?

C#では、データ型に疑問符 '?' を付けることでnullable型を宣言できます。例えば、nullableな整数を宣言するには、int? nullableInt = null;と書きます。

C#のnullable型は生成されるレポートの堅牢性に影響を与えることがありますか?

はい、nullable型を使用することで、値が欠落している場合にオプションフィールドがエラーを引き起こさないようにすることで、生成されるレポートの堅牢性を高めることができます。IronPDFのようなライブラリは、これらの条件を効率的に管理するためにnullable型を利用できます。

nullable参照型はランタイムエラーを防ぐのにどのように役立ちますか?

C# 8.0で導入されたnullable参照型は、参照型がデフォルトでnull許容でないようにすることで、ランタイムエラーを防ぎます。これにより、null参照例外のリスクが減少し、コンパイル中に潜在的な問題を早期に発見することができます。

nullable型を管理する際のnull合体演算子の役割は何ですか?

null合体演算子 ?? は、nullable型がnullの場合にデフォルト値を提供することでnullable型の管理に使用されます。これによりコードが簡素化され、明示的なif-elseチェックを避けることができます。

C#でnullable型に値があるかどうかをどのように確認できますか?

C#では、HasValueプロパティを使用するか、変数を直接nullと比較することで、nullable型に値があるかどうかを判定できます。

C#アプリケーションでnullable型を使用する典型的なシナリオにはどのようなものがありますか?

Nullable型は、データが不完全またはオプショナルである可能性がある状況、例えばフォーム入力、設定、またはnull値を許可するデータベースとのインターフェースでよく使用されます。IronPDFのようなライブラリを使用して動的レポート生成に特に便利です。

nullable参照型の有効化はC#プロジェクトのコンパイルにどのように影響しますか?

C#プロジェクトでnullable参照型を有効にすることで、潜在的なnull参照問題に対するコンパイル時警告とエラーが発生し、問題を早期に発見してより堅牢なコード開発を促進します。

Jacob Mellor、Ironチームの最高技術責任者(CTO)
最高技術責任者(CTO)

ジェイコブ・メラーはIron Softwareの最高技術責任者(CTO)であり、C# PDFテクノロジーを開拓する先見的なエンジニアです。Iron Softwareのコアコードベースを支えるオリジナル開発者として、彼は創業以来、会社の製品アーキテクチャを形成し、CEOのCameron Rimingtonとともに、会社をNASA、Tesla、および世界的な政府機関にサービスを提供する50人以上の会社に変えました。1999年にロンドンで最初のソフトウェアビジネスを開業し、2005年に最初 for .NETコンポーネントを作成した後、Microsoftのエコシステム全体で複雑な問題を解決することを専門としました。

彼の主要なIronPDFとIron Suite .NETライブラリは、世界中で3000万以上のNuGetインストールを達成し、彼の基礎となるコードは世界中で使用されている開発者ツールに力を与え続けています。25年の商業経験と41年のコーディングの専門知識を持つJacobは、次世代の技術リーダーを指導しながら、エンタープライズグレードのC#、Java、Python PDFテクノロジーにおけるイノベーションの推進に注力しています。

Iron Support Team

We're online 24 hours, 5 days a week.
Chat
Email
Call Me