讲师中心 微信公众号
AI工具推荐 视频效率加速

Web.config connectionStrings add name配置 连接字符串名称

轻敏君_2921

轻敏君_2921

发布时间:2026-03-02 10:58:03

|

421人浏览过

|

来源于php中文网

原创

connectionStrings 的 name 属性必须全局唯一,重复会导致静默覆盖、取值失败或 NullReferenceException;需校验重名、避免非法字符、统一大小写、使用常量管理,并注意 configSource 和 transform 的影响。

web.config connectionstrings add name配置 连接字符串名称

connectionStrings 的 name 属性必须全局唯一

Web.config 里多个 <add> 节点如果用了重复的 name,运行时不会报错,但后续通过 ConfigurationManager.ConnectionStrings["xxx"] 只能取到最后一个同名项——前面的被静默覆盖了。

  • 检查所有 <add name="xxx"> 是否真的不重名,包括被 configSource 拆分出去的外部文件
  • 开发阶段建议在 Global.asax Application_Start 里加一段校验逻辑,遍历 ConfigurationManager.ConnectionStrings 并用 .Cast<ConnectionStringSettings>() 去查重名
  • IIS 部署后,web.config 可能被自动合并(比如从 machine.config 继承),实际生效的 name 列表可能比你写的多

name 值不能含空格或特殊字符,但大小写敏感

name 是 .NET 内部用作字典键的字符串,只支持字母、数字、下划线、短横线;空格、点号、中文、括号都会导致 ConfigurationErrorsException,错误信息通常是 Unrecognized attribute 'name' 或更隐蔽的 Object reference not set(因为取不到连接字符串对象)。

  • 合法示例:name="ProdDb"、name="legacy_api_v2"
  • 非法示例:name="prod db"、name="My.DB"、name="主库"
  • 注意:name="MyDB" 和 name="mydb" 在 .NET 中是两个不同键,别在代码里大小写写错

代码里读取时 name 必须和 config 完全一致,包括拼写和大小写

很多人改了 config 的 name 却忘了同步改 C# 里的字符串字面量,结果 ConfigurationManager.ConnectionStrings["AppDb"] 返回 null,接着调 .ConnectionString 就抛 NullReferenceException。

  • 推荐把 name 提成常量: public const string DbConnName = "AppDb";,两边共用
  • 调试时直接在 Watch 窗口输 ConfigurationManager.ConnectionStrings.Keys,看实际加载了哪些 name
  • 发布前用 PowerShell 快速检查:[xml](Get-Content web.config).configuration.connectionStrings.add.name

web.config 被转换时(如 Web.config Transform),name 可能被意外覆盖或删掉

Visual Studio 的 Web.Release.config transform 如果写了 xdt:Transform="SetAttributes(name)",但没配对的 xdt:Locator,就可能把所有 <add> 的 name 全改成同一个值。

  • 典型错误写法:<add name="ReleaseDb" ... xdt:Transform="SetAttributes(name)" /> —— 缺少 xdt:Locator="Match(name)"
  • 安全写法:先定位再改,例如 <add name="DevDb" ... xdt:Transform="SetAttributes(name)" xdt:Locator="Match(name)" />
  • transform 后生成的最终 web.config 不会高亮提示 name 冲突,得手动打开看或用 diff 工具比对

配置项名字看着小,但它是连接字符串在内存里唯一的身份证。拼错一个字母、漏掉一个下划线、或者 transform 时 locator 写漏了,后面查半天 null 引用都未必想到这儿。

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

6519

2023.08.02

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

549

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

1698

2024.03.01

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

6124

2023.10.24

pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

4624

2024.04.01

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

6017

2024.08.01

xml是什么格式的文件
xml是什么格式的文件

xml是一种纯文本格式的文件。xml指的是可扩展标记语言,标准通用标记语言的子集,是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容,可阅读本专题下面的相关文章。

2482

2024.11.28

c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

2238

2023.09.20

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

0

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn