1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762
|
<?xml version="1.0" encoding="utf-8"?>
<Type Name="WebConfigurationManager" FullName="System.Web.Configuration.WebConfigurationManager">
<TypeSignature Language="C#" Value="public static class WebConfigurationManager" />
<AssemblyInfo>
<AssemblyName>System.Web</AssemblyName>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="T:System.Web.Configuration.WebConfigurationManager" /> class allows you to access computer and application information. </para>
<para>Using <see cref="T:System.Web.Configuration.WebConfigurationManager" /> is the preferred way to work with configuration files related to Web applications. For client applications, use the <see cref="T:System.Configuration.ConfigurationManager" /> class. </para>
<para>Your application can extend the <see cref="N:System.Configuration" /> types or use them directly to handle configuration information, as explained in the following list:</para>
<list type="bullet">
<item>
<para>Handling configuration. To handle configuration information using the standard types, you use one of the following approaches:</para>
<list type="bullet">
<item>
<para>Accessing a section. To access configuration information for your application, you must use one of the GetSection methods provided by <see cref="T:System.Web.Configuration.WebConfigurationManager" />. For <appSettings> and <connectionStrings>, you use the <see cref="P:System.Web.Configuration.WebConfigurationManager.AppSettings" /> and <see cref="P:System.Web.Configuration.WebConfigurationManager.ConnectionStrings" /> properties. These methods perform read-only operations, use a single cached instance of the configuration, and are multithread aware.</para>
</item>
<item>
<para>Accessing configuration files. Your application can read and write configuration settings at any level, for itself or for other applications or computers, locally or remotely. You use one of the open methods provided by <see cref="T:System.Web.Configuration.WebConfigurationManager" />. These methods will return a <see cref="T:System.Configuration.Configuration" /> object, which in turn provides the required methods and properties to handle the underlying configuration files. These methods perform read or write operations and recreate the configuration data every time a file is opened.</para>
</item>
<item>
<para>Advanced configuration. More advanced configuration handling is provided by the types <see cref="T:System.Configuration.SectionInformation" />, <see cref="T:System.Configuration.PropertyInformation" />, <see cref="T:System.Configuration.PropertyInformationCollection" />, <see cref="T:System.Configuration.ElementInformation" />, <see cref="T:System.Configuration.ContextInformation" />, <see cref="T:System.Configuration.ConfigurationSectionGroup" />, and <see cref="T:System.Configuration.ConfigurationSectionGroupCollection" />. </para>
</item>
</list>
</item>
<item>
<para>Extending configuration standard types. You can also provide your custom configuration elements by extending the standard configuration types such as <see cref="T:System.Configuration.ConfigurationElement" />, <see cref="T:System.Configuration.ConfigurationElementCollection" />, <see cref="T:System.Configuration.ConfigurationProperty" />, and <see cref="T:System.Configuration.ConfigurationSection" /> by using a programmatic or an attributed model. Refer to the <see cref="T:System.Configuration.ConfigurationSection" /> class for an example of how to extend a standard configuration type programmatically. Refer to the <see cref="T:System.Configuration.ConfigurationElement" /> class for an example of how to extend a standard configuration type using the attributed model.</para>
</item>
</list>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Provides access to configuration files as they apply to Web applications.</para>
</summary>
</Docs>
<Members>
<Member MemberName="AppSettings">
<MemberSignature Language="C#" Value="public static System.Collections.Specialized.NameValueCollection AppSettings { get; }" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.Collections.Specialized.NameValueCollection</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>An <see cref="T:System.Configuration.AppSettingsSection" /> object contains the configuration file's <appSettings> section.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the Web site's application settings.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="ConnectionStrings">
<MemberSignature Language="C#" Value="public static System.Configuration.ConnectionStringSettingsCollection ConnectionStrings { get; }" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.Configuration.ConnectionStringSettingsCollection</ReturnType>
</ReturnValue>
<Docs>
<value>To be added.</value>
<remarks>To be added.</remarks>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Gets the Web site's connection strings.</para>
</summary>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="GetSection">
<MemberSignature Language="C#" Value="public static object GetSection (string sectionName);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="sectionName" Type="System.String" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>If <see cref="M:System.Web.Configuration.WebConfigurationManager.GetSection(System.String)" /> is called from within a Web application, it gets the section from the configuration file selected by the system according to the Web-application configuration hierarchy. </para>
<block subset="none" type="note">
<para>If your application uses a different protocol than HTTP, the <see cref="M:System.Web.Configuration.WebConfigurationManager.GetSection(System.String,System.String)" /> overload that takes both a section name and a path in its parameter list is the one to use. You must specify the configuration file path because the system cannot make any assumptions about the configuration hierarchy level. If you use the <see cref="M:System.Web.Configuration.WebConfigurationManager.GetSection(System.String)" /> overload that takes only a section name, the system will always attempt to return the configuration settings at the application level. Note, though, that if its specified path is outside of the current application, the overload that takes a path will also return the application-level configuration settings for the currently running application.</para>
</block>
<para>You could call <see cref="M:System.Web.Configuration.WebConfigurationManager.GetSection(System.String)" /> from within a client application. In this case, it gets the default section from the configuration file selected by the system according to the client configuration hierarchy. Usually, this is the Machine.config file, unless you have a mapped configuration in place. For mapping configuration files, refer to the mapping methods described next.</para>
<block subset="none" type="note">
<para>The <see cref="M:System.Web.Configuration.WebConfigurationManager.GetSection(System.String)" /> method is a run-time method that operates on the section of a configuration file at the hierarchy level in which the application runs. For a non-run-time operation, use <see cref="M:System.Configuration.Configuration.GetSection(System.String)" /> instead. This method operates on the specified section of a configuration file that you obtain using one of the overloaded methods for opening a configuration file, <see cref="Overload:System.Web.Configuration.WebConfigurationManager.OpenWebConfiguration" />.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Retrieves the specified configuration section from the current Web application's configuration file.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The specified configuration section object, or null if the section does not exist. Remember that security restrictions exist on the use of <see cref="M:System.Web.Configuration.WebConfigurationManager.GetSection(System.String)" /> as a runtime operation. You might not be able to access a section at run time for modifications, for example.</para>
</returns>
<param name="sectionName">
<attribution license="cc4" from="Microsoft" modified="false" />The configuration section name.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="GetSection">
<MemberSignature Language="C#" Value="public static object GetSection (string sectionName, string path);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="sectionName" Type="System.String" />
<Parameter Name="path" Type="System.String" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>If <see cref="M:System.Web.Configuration.WebConfigurationManager.GetSection(System.String,System.String)" /> is called from within a Web application, it gets the section from the configuration file defined by the specified path in the configuration hierarchy. </para>
<block subset="none" type="note">
<para>If your application uses a different protocol than HTTP, the <see cref="M:System.Web.Configuration.WebConfigurationManager.GetSection(System.String,System.String)" /> overload that takes both a section name and a path in its parameter list is the one to use. You must specify the configuration file path because the system cannot make any assumptions about the configuration hierarchy level. If you use the <see cref="M:System.Web.Configuration.WebConfigurationManager.GetSection(System.String)" /> overload that takes only a section name, the system will always attempt to return the configuration settings at the application level. Note, though, that if its specified path is outside of the current application, the overload that takes a path will also return the application-level configuration settings for the currently running application.</para>
</block>
<para>This method cannot be called from within a client application.</para>
<para>If you want to retrieve the configuration section from the configuration file located at the current Web application directory level, use the <see cref="M:System.Web.Configuration.WebConfigurationManager.GetSection(System.String)" /> method. </para>
<block subset="none" type="note">
<para>The <see cref="M:System.Web.Configuration.WebConfigurationManager.GetSection(System.String,System.String)" /> method is a run-time method operating on the section of a configuration file at the hierarchy level in which the application runs. For a non-run-time operation, use <see cref="M:System.Configuration.Configuration.GetSection(System.String)" /> instead. This method operates on the specified section of a configuration file that you obtain using one of the open configuration file methods.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Retrieves the specified configuration section from the Web application's configuration file at the specified location.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The specified configuration section object, or null if the section does not exist. Remember that security restrictions exist on the use of <see cref="M:System.Web.Configuration.WebConfigurationManager.GetSection(System.String,System.String)" /> as a run-time operation. You might not be able to access a section at run time for modifications, for instance.</para>
</returns>
<param name="sectionName">
<attribution license="cc4" from="Microsoft" modified="false" />The configuration section name.</param>
<param name="path">
<attribution license="cc4" from="Microsoft" modified="false" />The virtual configuration file path.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="GetWebApplicationSection">
<MemberSignature Language="C#" Value="public static object GetWebApplicationSection (string sectionName);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Object</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="sectionName" Type="System.String" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>If <see cref="M:System.Web.Configuration.WebConfigurationManager.GetWebApplicationSection(System.String)" /> is called from within a Web application, it gets the section from the configuration file selected by the system according to the Web-application configuration hierarchy. </para>
<para>You could call <see cref="M:System.Web.Configuration.WebConfigurationManager.GetWebApplicationSection(System.String)" /> from within a client application. In this case, it gets the default section from the configuration file selected by the system according to the client configuration hierarchy. Usually, this is the Machine.config file, unless you have a mapped configuration in place. For mapping configuration files, refer to the mapping methods described next.</para>
<block subset="none" type="note">
<para>The <see cref="M:System.Web.Configuration.WebConfigurationManager.GetWebApplicationSection(System.String)" /> method is a run-time operation that acts on the section of the application configuration file located at the current level. The <see cref="M:System.Configuration.Configuration.GetSection(System.String)" /> method, however, is not a run-time operation but acts on the specified section obtained through one of the methods for opening the configuration files.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Retrieves the specified configuration section from the current Web application's configuration file.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The specified configuration section object, or null if the section does not exist, or an internal object if the section is not accessible at run time.</para>
</returns>
<param name="sectionName">
<attribution license="cc4" from="Microsoft" modified="false" />The configuration section name.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="OpenMachineConfiguration">
<MemberSignature Language="C#" Value="public static System.Configuration.Configuration OpenMachineConfiguration ();" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Configuration.Configuration</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>The <see cref="M:System.Configuration.ConfigurationManager.OpenMachineConfiguration" /> method opens the machine-configuration file on the computer where the application runs. This file is located in the standard build directory %windir%\Microsoft.NET\Framework\version\config.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Opens the machine-configuration file on the current computer as a <see cref="T:System.Configuration.Configuration" /> object to allow read or write operations.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Configuration.Configuration" /> object.</para>
</returns>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="OpenMachineConfiguration">
<MemberSignature Language="C#" Value="public static System.Configuration.Configuration OpenMachineConfiguration (string locationSubPath);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Configuration.Configuration</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="locationSubPath" Type="System.String" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method opens the machine-configuration file that is applicable to the directory specified by the <paramref name="locationSubPath" /> parameter. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Opens the machine-configuration file on the current computer as a <see cref="T:System.Configuration.Configuration" /> object to allow read or write operations.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Configuration.Configuration" /> object.</para>
</returns>
<param name="locationSubPath">
<attribution license="cc4" from="Microsoft" modified="false" />The application path to which the machine configuration applies.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="OpenMachineConfiguration">
<MemberSignature Language="C#" Value="public static System.Configuration.Configuration OpenMachineConfiguration (string locationSubPath, string server);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Configuration.Configuration</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="locationSubPath" Type="System.String" />
<Parameter Name="server" Type="System.String" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method opens the machine-configuration file that is located in the directory specified by the <paramref name="locationSubPath" /> parameter and on the computer specified by the <paramref name="server" /> parameter.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Opens the specified machine-configuration file on the specified server as a <see cref="T:System.Configuration.Configuration" /> object to allow read or write operations.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Configuration.Configuration" /> object.</para>
</returns>
<param name="locationSubPath">
<attribution license="cc4" from="Microsoft" modified="false" />The application path to which the configuration applies.</param>
<param name="server">
<attribution license="cc4" from="Microsoft" modified="false" />The fully qualified name of the server to return the configuration for.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="OpenMachineConfiguration">
<MemberSignature Language="C#" Value="public static System.Configuration.Configuration OpenMachineConfiguration (string locationSubPath, string server, IntPtr userToken);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Configuration.Configuration</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="locationSubPath" Type="System.String" />
<Parameter Name="server" Type="System.String" />
<Parameter Name="userToken" Type="System.IntPtr" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method is used to access a configuration file using impersonation. </para>
<block subset="none" type="note">
<para>The account token is usually retrieved from an instance of the <see cref="T:System.Security.Principal.WindowsIdentity" /> class or through a call to unmanaged code, such as a call to the Win32 API LogonUser. For more information about calls to unmanaged code, see <format type="text/html"><a href="eca7606e-ebfb-4f47-b8d9-289903fdc045">Consuming Unmanaged DLL Functions</a></format>.</para>
</block>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Opens the specified machine-configuration file on the specified server as a <see cref="T:System.Configuration.Configuration" /> object, using the specified security context to allow read or write operations.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Configuration.Configuration" /> object.</para>
</returns>
<param name="locationSubPath">
<attribution license="cc4" from="Microsoft" modified="false" />The application path to which the configuration applies.</param>
<param name="server">
<attribution license="cc4" from="Microsoft" modified="false" />The fully qualified name of the server to return the configuration for.</param>
<param name="userToken">
<attribution license="cc4" from="Microsoft" modified="false" />An account token to use.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="OpenMachineConfiguration">
<MemberSignature Language="C#" Value="public static System.Configuration.Configuration OpenMachineConfiguration (string locationSubPath, string server, string userName, string password);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Configuration.Configuration</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="locationSubPath" Type="System.String" />
<Parameter Name="server" Type="System.String" />
<Parameter Name="userName" Type="System.String" />
<Parameter Name="password" Type="System.String" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method is used to access a configuration file using impersonation. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Opens the specified machine-configuration file on the specified server as a <see cref="T:System.Configuration.Configuration" /> object, using the specified security context to allow read or write operations.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Configuration.Configuration" /> object.</para>
</returns>
<param name="locationSubPath">
<attribution license="cc4" from="Microsoft" modified="false" />The application path to which the configuration applies. </param>
<param name="server">
<attribution license="cc4" from="Microsoft" modified="false" />The fully qualified name of the server to return the configuration for.</param>
<param name="userName">
<attribution license="cc4" from="Microsoft" modified="false" />The full user name (Domain\User) to use when opening the file.</param>
<param name="password">
<attribution license="cc4" from="Microsoft" modified="false" />The password for the user name.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="OpenMappedMachineConfiguration">
<MemberSignature Language="C#" Value="public static System.Configuration.Configuration OpenMappedMachineConfiguration (System.Configuration.ConfigurationFileMap fileMap);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Configuration.Configuration</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="fileMap" Type="System.Configuration.ConfigurationFileMap" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Opens the machine-configuration file as a <see cref="T:System.Configuration.Configuration" /> object, using the specified file mapping to allow read or write operations. </para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Configuration.Configuration" /> object.</para>
</returns>
<param name="fileMap">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Configuration.ConfigurationFileMap" /> object to use in place of the default machine-configuration file.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="OpenMappedMachineConfiguration">
<MemberSignature Language="C#" Value="public static System.Configuration.Configuration OpenMappedMachineConfiguration (System.Configuration.ConfigurationFileMap fileMap, string locationSubPath);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Configuration.Configuration</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="fileMap" Type="System.Configuration.ConfigurationFileMap" />
<Parameter Name="locationSubPath" Type="System.String" />
</Parameters>
<Docs>
<remarks>To be added.</remarks>
<since version=".NET 2.0" />
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Opens the machine-configuration file as a <see cref="T:System.Configuration.Configuration" /> object using the specified file mapping and location to allow read or write operations.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Configuration.Configuration" /> object.</para>
</returns>
<param name="fileMap">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Configuration.ConfigurationFileMap" /> object to use in place of a default machine-configuration file.</param>
<param name="locationSubPath">
<attribution license="cc4" from="Microsoft" modified="false" />The specific resource to which the configuration applies.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="OpenMappedWebConfiguration">
<MemberSignature Language="C#" Value="public static System.Configuration.Configuration OpenMappedWebConfiguration (System.Web.Configuration.WebConfigurationFileMap fileMap, string path);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Configuration.Configuration</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="fileMap" Type="System.Web.Configuration.WebConfigurationFileMap" />
<Parameter Name="path" Type="System.String" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>To obtain the <see cref="T:System.Configuration.Configuration" /> object for a resource, your code must have read privileges on all the configuration files from which it inherits settings. To update a configuration file, your code must additionally have write privileges for both the configuration file and the directory in which it exists. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Opens the specified Web-application configuration file as a <see cref="T:System.Configuration.Configuration" /> object using the specified file mapping and virtual path to allow read or write operations.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Configuration.Configuration" /> object.</para>
</returns>
<param name="fileMap">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Configuration.WebConfigurationFileMap" /> object to use in place of a default Web-application configuration file.</param>
<param name="path">
<attribution license="cc4" from="Microsoft" modified="false" />The virtual path to the configuration file. </param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="OpenMappedWebConfiguration">
<MemberSignature Language="C#" Value="public static System.Configuration.Configuration OpenMappedWebConfiguration (System.Web.Configuration.WebConfigurationFileMap fileMap, string path, string site);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Configuration.Configuration</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="fileMap" Type="System.Web.Configuration.WebConfigurationFileMap" />
<Parameter Name="path" Type="System.String" />
<Parameter Name="site" Type="System.String" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>To obtain the <see cref="T:System.Configuration.Configuration" /> object for a resource, your code must have read privileges on all the configuration files from which it inherits settings. To update a configuration file, your code must additionally have write privileges for both the configuration file and the directory in which it exists. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Opens the specified Web application configuration file as a <see cref="T:System.Configuration.Configuration" /> object using the specified file mapping, virtual path, and site name to allow read or write operations.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Configuration.Configuration" /> object.</para>
</returns>
<param name="fileMap">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Configuration.WebConfigurationFileMap" /> object to use in place of a default Web-application configuration-file mapping.</param>
<param name="path">
<attribution license="cc4" from="Microsoft" modified="false" />The virtual path to the configuration file.</param>
<param name="site">
<attribution license="cc4" from="Microsoft" modified="false" />The name of the application Web site, as displayed in Internet Information Services (IIS) configuration.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="OpenMappedWebConfiguration">
<MemberSignature Language="C#" Value="public static System.Configuration.Configuration OpenMappedWebConfiguration (System.Web.Configuration.WebConfigurationFileMap fileMap, string path, string site, string locationSubPath);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Configuration.Configuration</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="fileMap" Type="System.Web.Configuration.WebConfigurationFileMap" />
<Parameter Name="path" Type="System.String" />
<Parameter Name="site" Type="System.String" />
<Parameter Name="locationSubPath" Type="System.String" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>To obtain the <see cref="T:System.Configuration.Configuration" /> object for a resource, your code must have read privileges on all the configuration files from which it inherits settings. To update a configuration file, your code must additionally have write privileges for both the configuration file and the directory in which it exists. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Opens the specified Web-application configuration file as a <see cref="T:System.Configuration.Configuration" /> object using the specified file mapping, virtual path, site name, and location to allow read or write operations.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Configuration.Configuration" /> object.</para>
</returns>
<param name="fileMap">
<attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Web.Configuration.WebConfigurationFileMap" /> object to use in place of a default Web-application configuration-file mapping.</param>
<param name="path">
<attribution license="cc4" from="Microsoft" modified="false" />The virtual path to the configuration file. </param>
<param name="site">
<attribution license="cc4" from="Microsoft" modified="false" />The name of the application Web site, as displayed in Internet Information Services (IIS) configuration.</param>
<param name="locationSubPath">
<attribution license="cc4" from="Microsoft" modified="false" />The specific resource to which the configuration applies.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="OpenWebConfiguration">
<MemberSignature Language="C#" Value="public static System.Configuration.Configuration OpenWebConfiguration (string path);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Configuration.Configuration</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="path" Type="System.String" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>To obtain the <see cref="T:System.Configuration.Configuration" /> object for a resource, your code must have read privileges on all the configuration files from which it inherits settings. To update a configuration file, your code must additionally have write privileges for both the configuration file and the directory in which it exists. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Opens the Web-application configuration file as a <see cref="T:System.Configuration.Configuration" /> object using the specified virtual path to allow read or write operations.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Configuration.Configuration" /> object.</para>
</returns>
<param name="path">
<attribution license="cc4" from="Microsoft" modified="false" />The virtual path to the configuration file. If null, the root Web.config file is opened.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="OpenWebConfiguration">
<MemberSignature Language="C#" Value="public static System.Configuration.Configuration OpenWebConfiguration (string path, string site);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Configuration.Configuration</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="path" Type="System.String" />
<Parameter Name="site" Type="System.String" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>To obtain the <see cref="T:System.Configuration.Configuration" /> object for a resource, your code must have read privileges on all the configuration files from which it inherits settings. To update a configuration file, your code must additionally have write privileges for both the configuration file and the directory in which it exists. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Opens the Web-application configuration file as a <see cref="T:System.Configuration.Configuration" /> object using the specified virtual path and site name to allow read or write operations.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Configuration.Configuration" /> object.</para>
</returns>
<param name="path">
<attribution license="cc4" from="Microsoft" modified="false" />The virtual path to the configuration file. </param>
<param name="site">
<attribution license="cc4" from="Microsoft" modified="false" />The name of the application Web site, as displayed in Internet Information Services (IIS) configuration.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="OpenWebConfiguration">
<MemberSignature Language="C#" Value="public static System.Configuration.Configuration OpenWebConfiguration (string path, string site, string locationSubPath);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Configuration.Configuration</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="path" Type="System.String" />
<Parameter Name="site" Type="System.String" />
<Parameter Name="locationSubPath" Type="System.String" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>To obtain the <see cref="T:System.Configuration.Configuration" /> object for a resource, your code must have read privileges on all the configuration files from which it inherits settings. To update a configuration file, your code must additionally have write privileges for both the configuration file and the directory in which it exists. </para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Opens the Web-application configuration file as a <see cref="T:System.Configuration.Configuration" /> object using the specified virtual path, site name, and location to allow read or write operations.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Configuration.Configuration" /> object.</para>
</returns>
<param name="path">
<attribution license="cc4" from="Microsoft" modified="false" />The virtual path to the configuration file. </param>
<param name="site">
<attribution license="cc4" from="Microsoft" modified="false" />The name of the application Web site, as displayed in Internet Information Services (IIS) configuration.</param>
<param name="locationSubPath">
<attribution license="cc4" from="Microsoft" modified="false" />The specific resource to which the configuration applies.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="OpenWebConfiguration">
<MemberSignature Language="C#" Value="public static System.Configuration.Configuration OpenWebConfiguration (string path, string site, string locationSubPath, string server);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Configuration.Configuration</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="path" Type="System.String" />
<Parameter Name="site" Type="System.String" />
<Parameter Name="locationSubPath" Type="System.String" />
<Parameter Name="server" Type="System.String" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>To obtain the <see cref="T:System.Configuration.Configuration" /> object for a remote resource, your code must have administrative privileges on the remote computer.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Opens the Web-application configuration file as a <see cref="T:System.Configuration.Configuration" /> object using the specified virtual path, site name, location, and server to allow read or write operations.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Configuration.Configuration" /> object.</para>
</returns>
<param name="path">
<attribution license="cc4" from="Microsoft" modified="false" />The virtual path to the configuration file. </param>
<param name="site">
<attribution license="cc4" from="Microsoft" modified="false" />The name of the application Web site, as displayed in Internet Information Services (IIS) configuration.</param>
<param name="locationSubPath">
<attribution license="cc4" from="Microsoft" modified="false" />The specific resource to which the configuration applies. </param>
<param name="server">
<attribution license="cc4" from="Microsoft" modified="false" />The network name of the server the Web application resides on.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="OpenWebConfiguration">
<MemberSignature Language="C#" Value="public static System.Configuration.Configuration OpenWebConfiguration (string path, string site, string locationSubPath, string server, IntPtr userToken);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Configuration.Configuration</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="path" Type="System.String" />
<Parameter Name="site" Type="System.String" />
<Parameter Name="locationSubPath" Type="System.String" />
<Parameter Name="server" Type="System.String" />
<Parameter Name="userToken" Type="System.IntPtr" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method is used to access a configuration file using impersonation. </para>
<block subset="none" type="note">
<para>The account token is usually retrieved from an instance of the <see cref="T:System.Security.Principal.WindowsIdentity" /> class or through a call to unmanaged code, such as a call to the Win32 API LogonUser. For more information about calls to unmanaged code, see <format type="text/html"><a href="eca7606e-ebfb-4f47-b8d9-289903fdc045">Consuming Unmanaged DLL Functions</a></format>.</para>
</block>
<para>To obtain the <see cref="T:System.Configuration.Configuration" /> object for a remote resource, your code must have administrative privileges on the remote computer.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Opens the Web-application configuration file as a <see cref="T:System.Configuration.Configuration" /> object using the specified virtual path, site name, location, server, and security context to allow read or write operations.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Configuration.Configuration" /> object.</para>
</returns>
<param name="path">
<attribution license="cc4" from="Microsoft" modified="false" />The virtual path to the configuration file. </param>
<param name="site">
<attribution license="cc4" from="Microsoft" modified="false" />The name of the application Web site, as displayed in Internet Information Services (IIS) configuration.</param>
<param name="locationSubPath">
<attribution license="cc4" from="Microsoft" modified="false" />The specific resource to which the configuration applies.</param>
<param name="server">
<attribution license="cc4" from="Microsoft" modified="false" />The network name of the server the Web application resides on.</param>
<param name="userToken">
<attribution license="cc4" from="Microsoft" modified="false" />An account token to use.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
<Member MemberName="OpenWebConfiguration">
<MemberSignature Language="C#" Value="public static System.Configuration.Configuration OpenWebConfiguration (string path, string site, string locationSubPath, string server, string userName, string password);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Configuration.Configuration</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="path" Type="System.String" />
<Parameter Name="site" Type="System.String" />
<Parameter Name="locationSubPath" Type="System.String" />
<Parameter Name="server" Type="System.String" />
<Parameter Name="userName" Type="System.String" />
<Parameter Name="password" Type="System.String" />
</Parameters>
<Docs>
<since version=".NET 2.0" />
<remarks>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>This method is used to access a configuration file using impersonation. </para>
<para>To obtain the <see cref="T:System.Configuration.Configuration" /> object for a remote resource, your code must have administrative privileges on the remote computer.</para>
<para>You might need to run the <format type="text/html"><a href="6491c41e-e2b0-481f-9863-db3614d5f96b">ASP.NET IIS Registration Tool (Aspnet_regiis.exe)</a></format> with the -config+ option to enable access to the configuration files on the remote computer.</para>
</remarks>
<summary>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>Opens the Web-application configuration file as a <see cref="T:System.Configuration.Configuration" /> object using the specified virtual path, site name, location, server, and security context to allow read or write operations.</para>
</summary>
<returns>
<attribution license="cc4" from="Microsoft" modified="false" />
<para>A <see cref="T:System.Configuration.Configuration" /> object.</para>
</returns>
<param name="path">
<attribution license="cc4" from="Microsoft" modified="false" />The virtual path to the configuration file. </param>
<param name="site">
<attribution license="cc4" from="Microsoft" modified="false" />The name of the application Web site, as displayed in Internet Information Services (IIS) configuration.</param>
<param name="locationSubPath">
<attribution license="cc4" from="Microsoft" modified="false" />The specific resource to which the configuration applies. </param>
<param name="server">
<attribution license="cc4" from="Microsoft" modified="false" />The network name of the server the Web application resides on.</param>
<param name="userName">
<attribution license="cc4" from="Microsoft" modified="false" />The full user name (Domain\User) to use when opening the file.</param>
<param name="password">
<attribution license="cc4" from="Microsoft" modified="false" />The password for the user name.</param>
</Docs>
<AssemblyInfo>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
</AssemblyInfo>
</Member>
</Members>
</Type>
|