桌面端 on 云雾海的博客

关于WPF中xmlns的理解

Wed, 14 Jan 2026 22:04:53 +0800

关于WPF中xmlns的理解

命名空间映射

以一个通过Visual Studio直接创建的简单WPF项目为例，我们查看其MainWindow.xaml文件，这是一个纯粹的窗口：

<Window x:Class="Test.MainWindow"
 xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
 xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
 xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
 xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
 xmlns:local="clr-namespace:Test"
 mc:Ignorable="d"
 Title="MainWindow" Height="450" Width="800">
 <Grid>
 
 </Grid>
</Window>

其中这一部分很难理解：

x:Class="Test.MainWindow"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
xmlns:local="clr-namespace:Test"
mc:Ignorable="d"

微软官方文档说，这个部分的内容其实叫XAML命名空间映射。

命名空间重命名

我们知道，在C#中就存在命名空间，也就是我们的namespace。

而XAML则是微软基于XML开发的一种声明性语言，WPF是XAML最出名的使用者，而关于XAML的解析则由.NET框架实现，它常被用于定义构造用户界面（UI）。

显然这是两种不同的语言，但显然两者需要进行交互，那么XAML就需要一种功能来调用命名空间，而这就是xmlns（XML/XAML namespace）的功能。

我们知道，对于C#中，调用其它命名空间的一种方式就是使用using语句，比如：

using System.Collections.Generic;
List<string> list = new List<string>();

而xmlns也是类似这样的功能，我们可以通过类似于以下的方式创建一个我们自定义于命名空间叫Test下的一个TestButton控件：

xmlns:ts="clr-namespace:Test"
<ts:TestButton />

当然，如果更加准确一点形容，它在C#中应该更加类似于以下这种形式：

using ts = Test;
ts.TestButton = new ts.TestButton();

也就是说，xmlns:（name）这种格式有点类似于引用命名空间并重命名或重映射，这里就是把Test这个命名空间重映射为ts了。

但是和C#中非常大的不同是，C#可以不重映射，比如直接通过以下形式实现：

Test.TestButton = new Test.TestButton;

但是XAML中要引用命名空间则必须先使用xmlns语句将其重映射一遍，其中XAML中调用命名空间时使用的clr-namespace:是一个固定关键词，在这个关键词后面可以通过类似C#的方式来写命名空间，比如如果TestButton也是一个命名空间的话，那么就可以通过加.的方式进行连接：

xmlns:tb="clr-namespace:Test.TestButton"

这一点用C#的思想去理解就可以了。

而事实上，我们的xmlns:local就是这个功能，它提供的服务就是将项目的命名空间引用起来了，而这个local可以改成任意其他名称，不过通常我们不用改。

默认命名空间

现在我们大概理解了xmlns的作用，那么让我们重新回顾语句，会发现其中有一个没加:的语句，即：

xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"

这个语句其实代表了一个默认命名空间，而它后面跟的不是clr-namespace:而是一个网址。

事实上这个网址并不是一个网页，而是统一资源标识符（URI），使用这种格式而非命名空间名字，最大的原因是为了保证全局唯一性，因为microsoft.com这个网址是微软拥有的，所以这个URI只有微软能用，这个URI的信息主要如下：

http://schemas.microsoft.com/winfx/2006/xaml/presentation
 | | | | |
 公司 规范 年份 技术 具体组件

其中schemas代表模式或规范，而WinFx/2006就是WPF的代号和规范的年份，xaml代表用于XAML技术，presentation代表WPF的Presentation层。

补充一个使用技巧：当你想知道某个命名空间URI对应的实际程序集时，可以查看项目的*.csproj文件，里面会有相应的引用。比如默认WPF命名空间对应多个程序集引用。

简单理解，这一个自动生成的xmlns代表的就是WPF的整个库，而它没有:则是因为它将作为默认空间使用，在XAML中任何没有加前缀的控件，都会优先在这个命名空间里面寻找，比如：

<Button Content="Button" HorizontalAlignment="Center" VerticalAlignment="Center"/>

和我们前面的TestButton的调用方法不同，前面并没有加任何name:，所以这种Button就会直接在xmlns指向的默认命名空间中寻找。

否则，我们在前面加一个ts:：

<ts:Button Content="Button" HorizontalAlignment="Center" VerticalAlignment="Center"/>

只是加了一个ts:，现在就必须在一个xmlns:ts的命名空间里面寻找了，如果前面没有引用这个空间，或者空间里面没有Button这个类，那么就会报错。

特殊的x

我们发现在我们开始举例的XAML代码里面，最开始有一个x:Class，而后面才出现了xmlns:x=http://schemas.microsoft.com/winfx/2006/xaml。

并且通过我们刚才对URI的理解，我们发现这个x的URI和刚刚的xmlns的很相似，只是它的URI少了/presentation，这代表它似乎是直接对XAML本身的规范。

事实上在XAML中x也确实是一个比较特殊的命名空间，它提供的不是某些控件，而是XAML本身的一些语言特性或特殊操作。

而x:Class就是这个命名空间中一个比较重要的操作，它提供了XAML和C#后台代码的连接，比如在XAML中我们看到：

x:Class="Test.MainWindow"

这其实对应了C#后台代码的：

namespace Test
{
 public partial class MainWindow : Window
 {
 public MainWindow()
 {
 InitializeComponent();
 }
 }
}

可以发现，它们的命名空间和类名完美对应上了，在编译时，两个板块才能够连接在一起。

而它的原理就是指定了这个XAML编译后生成的局部类(partial class)应该与哪个C#类合并，这也解释了为什么C#中的类是partial的。

显然x在工作中并不是调用某个C#的类或方法，而是作为一种特殊工具来操作XAML本身。

而x的常用功能很多，比如我们在XAML中通过语句添加了一个Button控件，就像我们刚才那样：

<Button Content="Button" HorizontalAlignment="Center" VerticalAlignment="Center"/>

我们或许可以在VS的布局界面看到这个按钮，但是我们该如何在C#中调用这个按钮呢，其实要做的就是添加x:Name，比如：

<Button x:Name="button" Content="Button" HorizontalAlignment="Center" VerticalAlignment="Center"/>

现在，我们就可以在C#后台代码中通过变量名button直接访问控制这个控件了，操作变得非常简单。

关于x，常用的指令有：

x:Class - 连接XAML和C#后台代码
x:Name - 给控件起名字，用于后台访问
x:Key - 给资源（样式、模板等）起标识符
x:Type - 表示一个类型
x:Static - 引用静态成员

另外x这个名字是可以改的，因为它只是一个约定俗成的名字，其本身仍然遵守XAML的语法规则。但是通常不建议修改，因为一些库里面习惯了这个约定俗成的名字，改了很可能会出现一些意想不到的错误，而且也会降低代码可读性。

用于设计的d

我们还可以看到一个自动生成的命名空间：

xmlns:d="http://schemas.microsoft.com/expression/blend/2008"

d=Design，代表设计时。

它和x类似，不直接提供控件但是提供一些特殊服务，而这里的服务则是一些供Visual Studio设计器或者Blend中显示，而运行时会消失的特殊属性，比如：

<Window
 xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
 d:DesignHeight="450"
 d:DesignWidth="800">

这是在设计器里面提供了一个预览尺寸，方便在设计界面的时候看到效果，但是实际运行时窗口的大小则和这两个属性无关。

在实际项目开发中，特别是使用MVVM模式时，d:命名空间提供的设计时数据功能非常有用。比如：

d:DataContext="{d:DesignInstance Type=local:MainViewModel}"

这可以在设计器里显示绑定数据的效果，避免"设计时一片空白"的问题。所以对于专业WPF开发，d:是很有价值的工具。

不过你如果担心它会污染你的代码，出现一些意想不到的错误，其实可以放心，因为下面一个命名空间的功能解决了这个问题。

标记兼容性的mc

继续往下看，我们可以发现两个语句：

xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
mc:Ignorable="d"

这里面都出现了mc命名空间，mc=Markup Compatibility，即标记兼容性。

这个命名空间通常与d:配合使用，它会告诉编译器，有些标记只是设计时使用的，运行的时候可以忽略，即mc:Ignorable="d"。

如果没有这个声明，编译器在看到d:DesignHeight时可能会产生困惑，这个属性是什么，自己似乎并未见过（因为这个功能只在设计器或Blend中被调用实现了）。

此外，利用mc的一些特性，可以将某些实验功能或未来版本的功能标记为可忽略，这样旧版本的编译器就不会报错。

同样，大部分时候我们不需要关注这个标记的用法，需要用的时候再自行查询即可。

总结：xmlns的层次结构

默认命名空间 (xmlns="...") - WPF核心控件库
x命名空间 (xmlns:x="...") - XAML语言特性
自定义映射 (xmlns:别名="clr-namespace:...") - 引用自己的代码
设计时支持 (xmlns:d="...") - 设计器辅助功能
兼容性处理 (xmlns:mc="...") - 版本和工具兼容

这种分层设计让XAML既能使用框架控件，又能扩展自定义功能，同时支持设计时和运行时的不同需求。

Winform自定义一个圆形按钮

Sun, 21 Mar 2021 22:45:35 +0800

因为我是电子专业的，学校没教过C#，学下来也基本上都是野路子东看西看基于需求地乱学，故而对C#的理解并不是很深。然而个人项目需要自定义一个控件来实现动态连线功能，不得不从入门直接跳到高级应用进行学习，这里做一个记录以对后面有类似需要的朋友一个参考。目前只是实现了一个简单的变色按钮功能，但是需要使用的大部分技术都用上了，如果需要实现其它更复杂功能的话就把本文当个抛砖引玉吧。

本文参考了《[C#] （原创）一步一步教你自定义控件——01，TrackBar》,但是在其基础上增加了设置控件区域的功能。另外因为那篇文章被很多人盗用，原文已经不可考，所以不贴地址给他们引流了，如果有需要可以直接百度这个名字即可。

新建工程

新建一个项目，选择Windows窗体控件库(.NET Framwork)，然后选择地址、命名。

正常情况下工程里应该有一个UserControl1.cs文件，不要它，直接删除，然后新建一个没有模板的类。

将此类的访问属性改为public并且继承自Control，如果Control下出现波浪线报错的话是因为没有引用其命名空间，可以按住Alt + Enter后选中第一个命名空间再按一次Enter进行修改，VS将自动添加上using System.Windows.Forms;。

添加属性

然后我们根据需求进行添加属性，因为这个功能只是需要实现一个圆形开关，那么我们需要知道的属性就有开关打开时的颜色，开关关闭时的颜色，圆形开关的直径，开关的状态四个属性。颜色使用Color类进行定义，直径使用int或者float进行定义，开关状态用布尔进行定义，并且给他们赋值上初始值。

private Color openColor = Color.FromArgb(128, 255, 128);	// 开启默认浅绿色
private Color closeColor = Color.FromArgb(255, 128, 128);	// 关闭默认浅红色
private int diameter = 20;	// 直径默认20，且为整数类型
private bool isOpen = false;	// 默认关闭

然后为他们添加上各自的访问器：

我们可以注意到，他们各自的get访问器其实没啥特别的，但是set访问器中除了基本的赋值以外，每个访问器中都有Invalidate();这么一句，它的工作目的是重新绘制一遍控件。

一般来说，如果你调整的这个属性将会影响到当前控件的外观，那么就有必要加上这么一句，它的功能类似于将原本的控件从你的屏幕上删除，然后根据新的定义创建一个新的控件。

然后我们再观察直径的访问器中使用了Size = new Size(diameter, diameter);这么一句话，它的目的是什么呢？其实从语义上就可以推测知道，是重新赋值了大小属性，其中宽度和长度变成了直径的。但是理论上其实不加这句也没有问题，因为我们后面会使用一个指定边界函数实现相同功能，但是如果不加上的话我们在使用Winform的设计模式的时候就容易出现bug，调整大小的时候，如果调大就会出现内容消失的情况，需要手动去调整一下才能重新刷新出来。我理解的原因是设计模式其实开启了一个模拟窗口，但是这里我们修改属性值的时候只有一些基础属性会被显示出来而不会触发具体的方法函数。故而我们不能运行后面那个指定边界函数进行样式的刷新，导致出现视觉bug。

然后另一个需要注意的是，我们在IsOpen中使用了一个TestSwitch的事件，如果我们的开关状态发生了改变，那么就会触发这个事件。后来如果我们需要，可以为这个事件增加功能，一旦IsOpen被赋值，就可以执行相应的功能。

不过我们如果需要使用这个功能的话，就还需要添加上委托和事件的定义，一般情况下我们在命名空间内写委托，然后在类里定义事件。

但是，我们知道如果想使用VS的设计器的话可以利用属性栏修改控件的属性，所以我们自定义的控件自然也想要相同的功能。此时需要输入[Category("属性分类"), Description("功能描述")]即可添加这些功能。其中属性分类的目的是为了方便我们找到我们自定义的这些功能，而功能描述则是方便使用的时知道该如何填入所需的属性。如果这里出现了报错，同样是因为没有引用所需的命名空间，只需要像前面一样按住Alt + Enter然后进行修正即可。

以下是我定义的所有的属性以及他们的描述。

		private Color openColor = Color.FromArgb(128, 255, 128);
 [Category("DemoUI"), Description("开启时的颜色")]
 public Color OpenColor
 {
 get { return openColor; }
 set
 {
 openColor = value;
 Invalidate();
 }
 }

 private Color closeColor = Color.FromArgb(255, 128, 128);
 [Category("DemoUI"), Description("关闭时的颜色")]
 public Color CloseColor
 {
 get { return closeColor; }
 set
 {
 closeColor = value;
 Invalidate();
 }
 }

 private int diameter = 20;
 [Category("DemoUI"), Description("圆直径")]
 public int Diameter
 {
 get { return diameter; }
 set
 {
 diameter = value;
 Size = new Size(diameter, diameter);
 Invalidate();
 }
 }

 private bool isOpen = false;
 [Category("DemoUI"), Description("开关状态")]
 public bool IsOpen
 {
 get { return isOpen; }
 set
 {
 isOpen = value;
 Invalidate();
 TestSwitch?.Invoke(this, new TestEventArgs(isOpen));
 }
 }

添加方法

完成了上述工作后，我们还需要为这个控件添加一些方法，然后他就可以成为真正的控件了。

首先，我们需要重写SetBoundsCore方法，这个方法可以定义控件的边界工作，根据微软给的定义，通过这个方法可以控制控件的Left、Top、Width、Height和BoundSpecified值，其中Left和Top控制着控件的位置，而Width和Height控制着控件边界的大小，而最后一个参数是枚举，不过功能没搞懂是做啥的，但是实际应用中不管也没事，因为我们一般都是重写Width和Height就好了。

protected override void SetBoundsCore(int x, int y, int width, int height, BoundsSpecified specified)
{
	base.SetBoundsCore(x, y, Diameter, Diameter, specified);
}

通过这个重写，我们可以让边界大小始终等于圆的直径，其中base的意思是在重写是基于原本的方法进行重写。

然后我们还需要设置一个可以改变开关值的方法，因为我希望得到的效果是在点击控件时不会改变，而在放开时：如果在控件内放开鼠标可以改变值，而如果在控件外放开鼠标则保持原本只不变。这种情况下我们只需要重写OnMouseUp控件就好了，我重写的内容如下，内容一看就懂，就不多写注释了：

protected override void OnMouseUp(MouseEventArgs e)
{
	base.OnMouseUp(e);
 	if (Region.IsVisible(e.Location))
 	{
 		if (IsOpen)
		{
			IsOpen = false;
 		}
 		else
 		{
 			IsOpen = true;
 		}
 	}
}

然后我们再重写OnPaint方法，这个方法在我们每次调用Invalidate()的时候都会用到（就是前面每次我们调用set访问器的时候都会使用的那个函数），它的功能就是把控件在屏幕上画一遍（只是画一遍，并没有Invalidate中的清除原控件的功能）。

这里我们使用GDI+来画控件，当然事实上你也可以调用图片然后来实现，他们的原理相似。

首先我们需要让GDI+的分辨率提高（其实这个控件太简单了可能用不着，但是如果未来在画一些复杂的控件的时候可能需要）：

e.Graphics.SmoothingMode = System.Drawing.Drawing2D.SmoothingMode.HighQuality;

然后我们现在需要把圆画出来，因为在后面要切割，所以这里其实怎么画都没问题，不过为了严谨我们还是正规点画个圆就行。

if(isOpen == true)
{
	e.Graphics.FillEllipse(new SolidBrush(OpenColor),0, 0, Diameter, Diameter);
}
else
{
	e.Graphics.FillEllipse(new SolidBrush(CloseColor), 0, 0, Diameter, Diameter);
}

这两句话的意思是使用开启颜色或关闭颜色画个直径为我们设定直径的圆。

然后最重要的一步来了，虽然我们当前画出来了一个圆，它的样子和我们所需要的样式相同了，但是其本质上还是一个矩形，只是矩形上面画了一个圆而已，而在点击的时候其实点在这个矩形的空白部分我们仍然等同于点到了这个控件。

这时候，我们需要用Region把这个圆的区域抠出来，具体做法就是新建一个System.Drawing.Drawing2D.GraphicsPath的对象，然后用它在正确位置抠出一个和我们画出的圆一样大小的圆，这样就刚好吧我们需要的圆抠出来了。

System.Drawing.Drawing2D.GraphicsPath path = new System.Drawing.Drawing2D.GraphicsPath();
path.AddEllipse(0, 0, Diameter, Diameter);
Region = new Region(path);

现在，我们就真正有了一个圆形的开关了。

添加事件

之前我们在属性中使用的事件，可以自己新增事件库进行管理，新建类，然后将其设为public并继承自EventArgs，接着新建事件并设计这个事件的参数和执行的操作。

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

namespace DemoControls
{
 public class TestEventArgs : EventArgs
 {
 public TestEventArgs(object value)
 {
 Value = value;
 }

 public object Value { get; set; }
 }
}

同时我们还可以把这个事件设为默认事件，在开头部分我们定义这个控件类的默认事件为我们前面注册的TestSwitch。

使用这个控件

那么该如何使用这个控件呢？你可以新建一个工程（一般情况下建议新建工程来使用控件，而控件库单独用一个工程来管理，你未来所有的控件都可以放在控件库里），如果在本解决方案中的话，只需要在解决方案管理器中右键点击你的控件库工程名，选择生成，然后你就可以当前解决方案的任意工程中使用你控件库里的所有控件了。

而如果你需要在外部使用你的控件库，可以在生成后，进入到你的工程文件夹，Debug或者Release文件夹里的dll文件。如果你需要在某一个工程中使用这个控件的话，就在新工程里点击工具-选择工具箱项，点击浏览，然后添加刚才那个dll文件即可。

现在我们在当前解决方案试试看吧：

生成文件、新建工程、然后开始使用设计页面，可以发现设计页面最开头添加了我们的控件库：

然后我们拖出来两个，设置一下他们的大小和颜色：

同时双击第一个控件增添事件功能：

最后启动：

成功。

完整的工程下载地址