.NET Framework 类库
FrameworkElement..::.Style 属性

更新:2007 年 11 月

获取或设置此元素在呈现时使用的样式。这是一个依赖项属性。

命名空间:  System.Windows
程序集:  PresentationFramework(在 PresentationFramework.dll 中)
用于 XAML 的 XMLNS:http://schemas.microsoft.com/winfx/xaml/presentation

语法

Visual Basic(声明)
Public Property Style As Style
Visual Basic (用法)
Dim instance As FrameworkElement
Dim value As Style

value = instance.Style

instance.Style = value
C#
public Style Style { get; set; }
Visual C++
public:
property Style^ Style {
    Style^ get ();
    void set (Style^ value);
}
J#
/** @property */
public Style get_Style()
/** @property */
public  void set_Style(Style value)
JScript
public function get Style () : Style
public function set Style (value : Style)
XAML 属性用法
<object Style="{resourceExtension styleResourceKey}"/>
XAML 值
resourceExtension

以下用法之StaticResource DynamicResource。请参见 资源概述

styleResourceKey

标识所请求样式的键。该键引用 ResourceDictionary 中的现有资源。

属性值

类型:System.Windows..::.Style

此元素的已应用的非默认样式(如果存在)。否则为 nullNothingnullptrnull 引用(在 Visual Basic 中为 Nothing。默认情况下构造的 FrameworkElement 的默认值为 nullNothingnullptrnull 引用(在 Visual Basic 中为 Nothing

依赖项属性信息

标识符字段

StyleProperty

设置为 true 的元数据属性

AffectsMeasure

备注

对于控件而言,当前样式通常由控件主题中的默认样式提供,或由页或应用程序级别的资源通常应用于该类型控件的样式提供(隐式样式)。此属性不会设置或返回默认(主题)样式,但它确实会返回应用于元素的隐式样式或显式样式。对于隐式或显式样式而言,是将样式指定为资源还是在本地定义样式都无关紧要。

设置样式有一些限制。您可以随时将整个 Style 属性重置为新的 Style,这将强制进行布局的重新组合。但是,在将该样式提供给已加载的元素使用之后,就应该立即将 Style 视为密封的。尝试对正在使用的样式(如 Setters 集合中的任何样式)的任何单个属性进行更改都将引发异常。对于在标记中定义的样式,一旦从资源字典加载它之后(对于资源),或者加载包含它的页之后(对于内联样式),就将其视为正在使用。

Style 是一个具有特殊优先级的依赖项属性。本地设置的样式通常在属性系统中具有最高优先级。如果 Style 目前为 null,则在加载过程中,属性系统将在本地或应用程序资源中检查是否存在指定该类型的隐式样式。如果在此步骤之后样式仍然为 null,则用于呈现的有效样式通常来自默认(主题)样式,但该默认样式不会在 Style 属性值中返回。请参见依赖项属性值优先级样式设置和模板化

示例

下面的示例在资源字典中定义了一个样式。

XAML
<Page.Resources>


...


<Style TargetType="Border" x:Key="PageBackground">
  <Setter Property="Background" Value="Blue"/>
</Style>


...


<Border Style="{StaticResource PageBackground}">


...


</Border>
平台

Windows Vista

.NET Framework 和 .NET Compact Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求

版本信息

.NET Framework

受以下版本支持:3.5、3.0
另请参见

参考

其他资源

标记 :


Page view tracker