NullExtension クラス


XAML で値を明示的に null に設定するときに使用できる null オブジェクトを返すために、XAML マークアップ拡張機能を実装します。Implements a XAML markup extension in order to return a null object, which you can use to explicitly set values to null in XAML.

public ref class NullExtension : System::Windows::Markup::MarkupExtension
public class NullExtension : System.Windows.Markup.MarkupExtension
type NullExtension = class
    inherit MarkupExtension
Public Class NullExtension
Inherits MarkupExtension


XAML では、通常、null と空の文字列は等価ではありません。In XAML, null and empty string are generally not equivalent. 基になる{x:Null}プロパティをにnull設定する属性を設定するために、拡張機能の使用法を使用します。You use the {x:Null} extension usage in order to set an attribute that sets the underlying property to null. XAML のシナリオにおける null 値の設定方法の詳細については、「 X:Null Markup Extension」を参照してください。For more information on how setting null values is relevant for scenarios in XAML, see x:Null Markup Extension.

このクラスは、マークアップ拡張機能の実装です。This class is a markup extension implementation. マークアップ拡張クラスは、主に、XAML プロセッサが特定の拡張機能を解釈する方法についてのインフラストラクチャサポートを提供するために存在します。Markup extension classes exist mainly to provide infrastructure support for how XAML processors interpret a particular extension. マークアップ拡張機能の実装クラスが公開するメンバーは、通常、コードから呼び出すことを意図していません。The members that markup extension implementation classes expose are not typically intended to be called from your code. このマークアップ拡張クラスは、.NET XAML サービスのX:Null マークアップ拡張機能の使用をサポートします。This markup extension class supports the x:Null Markup Extension usage for .NET XAML Services.

以前のバージョンの .NET Framework では、このクラス (およびx:Nullマークアップ拡張機能の XAML 動作サポートと関連する xmlns マッピング) は、WPF 固有のアセンブリのプレゼンテーションフレームワークに存在していました。In previous versions of the .NET Framework, this class (and the x:Null markup extension XAML behavior support as well as the relevant xmlns mapping) existed in the WPF-specific assembly PresentationFramework. .NET Framework 4.NET Framework 4NullExtension 、は、システムの .xaml アセンブリにあります。In .NET Framework 4.NET Framework 4, NullExtension is in the System.Xaml assembly. これによりx:Null 、.net XAML サービスを参照するフレームワークを使用してアプリケーションで使用できるようになります。This makes the x:Null usage available to applications using frameworks that reference .NET XAML Services. を対象.NET Framework 4.NET Framework 4としている限り、参照アセンブリとしてのプレゼンテーションフレームワークは必要ありません。You do not need PresentationFramework as a referenced assembly so long as you are targeting .NET Framework 4.NET Framework 4. 詳細については、「 Types Migrated from WPF to System.Xaml」を参照してください。For more information, see Types Migrated from WPF to System.Xaml.

システムの .xaml アセンブリは、 XmlnsDefinitionAttributeを使用して、アセンブリ内のすべての型を xaml 言語 ( の xaml 名前空間にマップします。The System.Xaml assembly uses XmlnsDefinitionAttribute to map all types in the assembly to the XAML namespace for the XAML language ( 通常は、ルート要素のマッピングでのプレフィックスを宣言し、プレフィックスxを使用します。Typically you declare a prefix for in a root element mapping and use the prefix x.

WPF の使用上の注意WPF Usage Notes

WPF の依存関係プロパティの場合、依存関係プロパティの値nullをに設定すると、参照プロパティであっても、プロパティが既定値に設定されるとは限りません。For WPF dependency properties, when you set a dependency property value to null, you are not necessarily setting the property to its default value, even if it is a reference property. 依存関係プロパティの既定値は、依存関係プロパティの登録によって異なります。The default value of a dependency property depends on its dependency property registration. 値が設定されてnullいない場合UnsetValueは、「」を参照してください。An unset value is not necessarily null either; see UnsetValue. 詳細についてはClearValue 、「」または「依存関係プロパティの概要」を参照してください。For more information, see ClearValue or Dependency Properties Overview.



NullExtension クラスの新しいインスタンスを初期化します。Initializes a new instance of the NullExtension class.



指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(継承元 Object)

既定のハッシュ関数として機能します。Serves as the default hash function.

(継承元 Object)

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)

マークアップ拡張機能の出力の値として使用する null を提供します。Provides null to use as a value as the output of this markup extension.


現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(継承元 Object)