0

0

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

畫卷琴夢

畫卷琴夢

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

|

381人浏览过

|

来源于php中文网

原创

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

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

connectionStrings 的 name 属性必须全局唯一

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

  • 检查所有 <add name="xxx"></add> 是否真的不重名,包括被 configSource 拆分出去的外部文件
  • 开发阶段建议在 Global.asax Application_Start 里加一段校验逻辑,遍历 ConfigurationManager.ConnectionStrings 并用 .Cast<connectionstringsettings>()</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

PPT.AI
PPT.AI

AI PPT制作工具

下载
  • 推荐把 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></add> 的 name 全改成同一个值。

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

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

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

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
string转int
string转int

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

910

2023.08.02

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

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

249

2023.09.22

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

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

967

2024.03.01

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

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

1560

2023.10.24

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

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

1937

2024.04.01

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

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

2116

2024.08.01

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

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

1142

2024.11.28

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

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

557

2023.09.20

Golang 测试体系与代码质量保障:工程级可靠性建设
Golang 测试体系与代码质量保障:工程级可靠性建设

Go语言测试体系与代码质量保障聚焦于构建工程级可靠性系统。本专题深入解析Go的测试工具链(如go test)、单元测试、集成测试及端到端测试实践,结合代码覆盖率分析、静态代码扫描(如go vet)和动态分析工具,建立全链路质量监控机制。通过自动化测试框架、持续集成(CI)流水线配置及代码审查规范,实现测试用例管理、缺陷追踪与质量门禁控制,确保代码健壮性与可维护性,为高可靠性工程系统提供质量保障。

43

2026.02.28

热门下载

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

精品课程

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号