WPF から System.Xaml に移行された型

.NET Framework 3.5 および .NET Framework 3.0 では、Windows Presentation Foundation (WPF) と Windows Workflow Foundation の両方に、XAML 言語の実装が含まれていました。 WPF XAML 実装に拡張性を与えていたパブリック型の多くは、WindowsBase、PresentationCore、および PresentationFramework アセンブリに存在していました。 同様に、Windows Workflow Foundation の XAML に拡張性を提供していたパブリック型は、System.Workflow.ComponentModel アセンブリにありました。 .NET Framework 4 では、XAML 関連の型の一部が System.Xaml アセンブリに移行されました。 .NET Framework での XAML 言語サービスの一般的な実装では、もともと特定のフレームワークの XAML 実装によって定義されていた XAML 機能拡張のシナリオの多くを、今では全体的な .NET Framework 4 の XAML 言語サポートの一部として使用できるようになりました。 この記事では、移行された型の一覧を示し、移行に関連する問題について説明します。

アセンブリと名前空間

.NET Framework 3.5 と .NET Framework 3.0 では、XAML をサポートするために WPF で実装されていた型は、一般に System.Windows.Markup 名前空間にありました。 これらの型の多くは WindowsBase アセンブリにありました。

.NET Framework 4 には、新しい System.Xaml 名前空間と、新しい System.Xaml アセンブリがあります。 当初は WPF XAML 向けとして実装されていた型の多くが、今では XAML の任意の実装用の機能拡張ポイントまたはサービスとして提供されています。 より一般的なシナリオでも使用できるようにするため、型は元の WPF アセンブリから System.Xaml アセンブリに型転送されました。 これにより、他のフレームワーク (WPF や Windows Workflow Foundation など) のアセンブリを含めることなく、XAML 機能拡張シナリオを有効にできるようになりました。

移行した型のほとんどは、 System.Windows.Markup 名前空間に残っています。 これは、既存の実装で CLR 名前空間マッピングが破損するのをファイルごとに回避するための策でもあります。 その結果、.NET Framework 4 の System.Windows.Markup 名前空間には、XAML 言語をサポートする一般的な型 (System.Xaml アセンブリにあったもの) と、XAML の WPF 実装に固有の型 (WindowsBase およびその他の WPF アセンブリにあったもの) が混在しています。 System.Xaml に移行されたものの、以前は WPF アセンブリにあった型は、バージョン 4 の WPF アセンブリで型転送がサポートされています。

ワークフロー XAML サポート型

Windows Workflow Foundation では XAML のサポート型も提供されており、多くの場合は、WPF に相当する同じ短い名前でした。 Windows Workflow Foundation の XAML サポート型の一覧を次に示します。

• ContentPropertyAttribute

• RuntimeNamePropertyAttribute

• XmlnsPrefixAttribute

これらのサポート型は引き続き .NET Framework 4 の Windows Workflow Foundation アセンブリ内に存在し、特定の Windows Workflow Foundation アプリケーションで使用できますが、Windows Workflow Foundation を使用していないアプリケーションまたはフレームワークでは参照できません。

MarkupExtension

.NET Framework 3.5 および .NET Framework 3.0 では、WPF の MarkupExtension クラスは WindowsBase アセンブリにありました。 Windows Workflow Foundation の並列クラスである MarkupExtension は、System.Workflow.ComponentModel アセンブリにありました。 .NET Framework 4 では、MarkupExtension クラスは System.Xaml アセンブリに移行されています。 .NET Framework 4 では、MarkupExtension は、特定のフレームワーク上に構築される XAML 機能拡張シナリオだけではなく、.NET XAML サービスを使用する任意の XAML 機能拡張シナリオを対象としています。 特定のフレームワーク、またはフレームワーク内のユーザー コードも、可能な限り、XAML 機能拡張の MarkupExtension クラス上に構築する必要があります。

MarkupExtension をサポートするサービス クラス

WPF 向けの .NET Framework 3.5 と .NET Framework 3.0 では、MarkupExtension の実装担当者が使用できるいくつかのサービスと、XAML での型とプロパティの使用をサポートする TypeConverter の実装が提供されていました。 これらのサービスを次に示します。

• IProvideValueTarget

• IUriContext

• IXamlTypeResolver

注意

マークアップ拡張機能に関連する .NET Framework 3.5 のもう 1 つのサービスは、IReceiveMarkupExtension インターフェイスです。 IReceiveMarkupExtension は移行されておらず、.NET Framework 4 では [Obsolete]とマークされます。 以前に IReceiveMarkupExtension を使用していたシナリオは、代わりに XamlSetMarkupExtensionAttribute 属性付きコールバックを使用する必要があります。 AcceptedMarkupExtensionExpressionTypeAttribute も [Obsolete]とマーク付けされています。

XAML 言語機能

WPF 向けのいくつかの XAML 言語機能とコンポーネントは、以前は PresentationFramework アセンブリにありました。 これらの機能やコンポーネントは MarkupExtension のサブクラスとして実装され、XAML マークアップでのマークアップ拡張機能の使用を公開していました。 .NET Framework 4 では、これらは System.Xaml アセンブリにあるので、WPF アセンブリが組み込まれていないプロジェクトでも、これらの XAML 言語レベルの機能を使用できます。 WPF では、これらと同じ実装が .NET Framework 4 アプリケーションに対して使用されます。 このトピックで示す他のケースと同様に、サポート型は System.Windows.Markup 名前空間に引き続き存在するので、以前の参照は破損されません。

System.Xaml で定義されている XAML 機能のサポート クラスを次の表に示します。

XAML 言語機能	使用法
ArrayExtension	<x:Array ...>
NullExtension	{x:Null}
StaticExtension	{x:Static ...}
TypeExtension	{x:Type ...}

System.Xaml には特定のサポート クラスはありませんが、XAML 言語の言語機能を処理するための一般的なロジックは System.Xaml にあり、それを実装した XAML リーダーと XAML ライターにも含まれています。 たとえば、 x:TypeArguments は System.Xaml 実装の XAML リーダーと XAML ライターによって処理される属性です。これは XAML ノード ストリームで示すことができ、既定の (CLR ベースの) XAML スキーマ コンテキストに処理があり、XAML 型システム表現があります。 XAML のリファレンス ドキュメントの詳細については、「XAML サービス」を参照してください。

ValueSerializer とサポートするクラス

ValueSerializer クラスは、特に、シリアル化のために出力に複数のモードまたはノードが必要となる XAML シリアル化のケースで、文字列への型変換をサポートしています。 .NET Framework 3.5 および .NET Framework 3.0 では、WPF の ValueSerializer は WindowsBase アセンブリにありました。 .NET Framework 4 では、ValueSerializer クラスは System.Xaml にあり、WPF 上に構築される XAML 機能拡張シナリオだけではなく、すべての XAML 機能拡張シナリオを対象としています。 IValueSerializerContext (サポート サービス) および DateTimeValueSerializer (固有のサブクラス) も System.Xaml に移行されました。

XAML 関連の属性

WPF XAML には、XAML の動作について何かを示すために CLR 型に適用される属性がいくつか含まれています。 .NET Framework 3.5 および .NET Framework 3.0 で WPF アセンブリ内に存在していた属性の一覧を次に示します。 .NET Framework 4 では、これらの属性は System.Xaml に移行されました。

• AmbientAttribute

• ContentPropertyAttribute

• ContentWrapperAttribute

• DependsOnAttribute

• MarkupExtensionReturnTypeAttribute

• NameScopePropertyAttribute

• RootNamespaceAttribute

• RuntimeNamePropertyAttribute

• TrimSurroundingWhitespaceAttribute

• ValueSerializerAttribute

• WhitespaceSignificantCollectionAttribute

• XmlLangPropertyAttribute

• XmlnsCompatibleWithAttribute

• XmlnsDefinitionAttribute

• XmlnsPrefixAttribute

その他のクラス

IComponentConnector インターフェイスは、.NET Framework 3.5 と .NET Framework 3.0 では WindowsBase に存在しましたが、.NET Framework 4 では System.Xaml に存在します。 IComponentConnector は、主にツーリングのサポートと XAML マークアップ コンパイラーを目的としています。

INameScope インターフェイスは、.NET Framework 3.5 と .NET Framework 3.0 では WindowsBase に存在しましたが、.NET Framework 4 では System.Xaml に存在します。 INameScope は、XAML 名前空間に対する基本的な操作を定義します。

WPF と System.Xaml に存在する共通の名前を持つ XAML 関連クラス

次に示すクラスは、.NET Framework 4 では、WPF アセンブリと System.Xaml アセンブリの両方に存在します。

XamlReader

XamlWriter

XamlParseException

WPF 実装は、 System.Windows.Markup 名前空間にあり、PresentationFramework アセンブリに含まれています。 System.Xaml 実装は、 System.Xaml 名前空間にあります。 WPF 型を使用する場合や、WPF 型から派生する場合は、一般に、System.Xaml 実装ではなく XamlReader および XamlWriter の WPF 実装を使用する必要があります。 詳細については、 System.Windows.Markup.XamlReader および System.Windows.Markup.XamlWriterの解説セクションを参照してください。

WPF アセンブリと System.Xaml の両方を参照しており、 include 名前空間と System.Windows.Markup 名前空間の両方に対して System.Xaml ステートメントを使用している場合は、あいまいさを排除して型を解決するために、これらの API への呼び出しを完全修飾する必要があることがあります。