Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/core/diagnostics/debug-memory-leak.md
Original file line number Diff line number Diff line change
Expand Up @@ -140,7 +140,7 @@ dotnet-dump analyze core_20190430_185145
Where `core_20190430_185145` is the name of the core dump you want to analyze.

> [!NOTE]
> If you see an error complaining that *libdl.so* cannot be found, you may have to install the *libc6-dev* package. For more information, see [Prerequisites for .NET Core on Linux](../linux-prerequisites.md).
> If you see an error complaining that *libdl.so* cannot be found, you may have to install the *libc6-dev* package. For more information, see [Prerequisites for .NET Core on Linux](../install/dependencies.md?pivots=os-linux).

You'll be presented with a prompt where you can enter SOS commands. Commonly, the first thing you want to look at is the overall state of the managed heap:

Expand Down
2 changes: 1 addition & 1 deletion docs/core/introduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ ms.custom: "updateeachrelease"
---
# Introduction to .NET Core

[.NET Core](about.md) is an [open-source](https://github.com/dotnet/runtime/blob/master/LICENSE.TXT), general-purpose development platform. You can create .NET Core apps for Windows, macOS, and Linux for x64, x86, ARM32, and ARM64 processors using multiple programming languages. Frameworks and APIs are provided for [cloud](/aspnet/core/), [IoT](/archive/msdn-magazine/2019/august/net-core-cross-platform-iot-programming-with-net-core-3-0), [client UI](/dotnet/desktop-wpf/overview/index), and [machine learning](/dotnet/machine-learning/).
[.NET Core](about.md) is an [open-source](https://github.com/dotnet/runtime/blob/master/LICENSE.TXT), general-purpose development platform. You can create .NET Core apps for Windows, macOS, and Linux for x64, x86, ARM32, and ARM64 processors using multiple programming languages. Frameworks and APIs are provided for [cloud](/aspnet/core/), [IoT](/archive/msdn-magazine/2019/august/net-core-cross-platform-iot-programming-with-net-core-3-0), [client UI](../desktop-wpf/overview/index.md), and [machine learning](/dotnet/machine-learning/).

[Download the .NET Core SDK](https://dotnet.microsoft.com/download) to try .NET Core on your machine. The latest version is [.NET Core 3.1](https://devblogs.microsoft.com/dotnet/announcing-net-core-3-1/).

Expand Down
4 changes: 2 additions & 2 deletions docs/core/toc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -351,7 +351,7 @@
- name: Port Windows Forms projects
href: porting/winforms.md
- name: Port WPF projects
href: porting/wpf.md
href: ../desktop-wpf/migration/convert-project-from-net-framework.md
- name: Port C++/CLI projects
href: porting/cpp-cli.md
- name: Unit testing
Expand Down Expand Up @@ -418,7 +418,7 @@
- name: Create a .NET Core application with plugins
href: tutorials/creating-app-with-plugin-support.md
- name: How to use and debug assembly unloadability in .NET Core
href: ../standard/assembly/unloadability-howto.md
href: ../standard/assembly/unloadability.md
- name: .NET Core distribution packaging
href: distribution-packaging.md
- name: Expose .NET Core components to COM
Expand Down
2 changes: 1 addition & 1 deletion docs/core/versions/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -102,7 +102,7 @@ Each version of .NET Core implements a version of .NET Standard. Implementing a
## See also

- [Target frameworks](../../standard/frameworks.md)
- [.NET Core distribution packaging](../build/distribution-packaging.md)
- [.NET Core distribution packaging](../distribution-packaging.md)
- [.NET Core Support Lifecycle Fact Sheet](https://dotnet.microsoft.com/platform/support/policy)
- [.NET Core 2+ Version Binding](https://github.com/dotnet/designs/issues/3)
- [Docker images for .NET Core](https://hub.docker.com/_/microsoft-dotnet-core/)
2 changes: 1 addition & 1 deletion docs/core/whats-new/dotnet-core-2-1.md
Original file line number Diff line number Diff line change
Expand Up @@ -245,6 +245,6 @@ For information about breaking changes, see [Breaking changes for migration from

## See also

- [What's new in .NET Core](index.md)
- [What's new in .NET Core 3.1](dotnet-core-3-1.md)
- [New features in EF Core 2.1](/ef/core/what-is-new/ef-core-2.1)
- [What's new in ASP.NET Core 2.1](/aspnet/core/aspnetcore-2.1)
2 changes: 1 addition & 1 deletion docs/core/whats-new/dotnet-core-2-2.md
Original file line number Diff line number Diff line change
Expand Up @@ -91,6 +91,6 @@ See [Host startup hook](https://github.com/dotnet/core-setup/blob/master/Documen

## See also

- [What's new in .NET Core](index.md)
- [What's new in .NET Core 3.1](dotnet-core-3-1.md)
- [What's new in ASP.NET Core 2.2](/aspnet/core/release-notes/aspnetcore-2.2)
- [New features in EF Core 2.2](/ef/core/what-is-new/ef-core-2.2)
2 changes: 1 addition & 1 deletion docs/framework/app-domains/build-single-file-assembly.md
Original file line number Diff line number Diff line change
Expand Up @@ -83,4 +83,4 @@ vbc -out:myCodeLibrary.dll -t:library myCode.vb
- [Create assemblies](../../standard/assembly/create.md)
- [Multifile assemblies](multifile-assemblies.md)
- [How to: Build a multifile assembly](build-multifile-assembly.md)
- [Program with assemblies](../../standard/assembly/program.md)
- [Program with assemblies](../../standard/assembly/index.md)
Original file line number Diff line number Diff line change
Expand Up @@ -24,4 +24,4 @@ To share an assembly:

- [C# programming guide](../../../api/index.md)
- [Programming concepts (Visual Basic)](../../../api/index.md)
- [Program with assemblies](../../standard/assembly/program.md)
- [Program with assemblies](../../standard/assembly/index.md)
2 changes: 1 addition & 1 deletion docs/framework/app-domains/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ Provides links to all How-to topics found in the conceptual documentation for pr
[Using Application Domains](use.md)
Provides examples of creating, configuring, and using application domains.

[Programming with Assemblies](../../standard/assembly/program.md)
[Programming with Assemblies](../../standard/assembly/index.md)
Describes how to create, sign, and set attributes on assemblies.

## Related Sections
Expand Down
2 changes: 1 addition & 1 deletion docs/framework/app-domains/multifile-assemblies.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,4 +36,4 @@ Once you create the assembly, you can sign the file that contains the assembly m
## See also

- [How to: Build a multifile assembly](build-multifile-assembly.md)
- [Program with assemblies](../../standard/assembly/program.md)
- [Program with assemblies](../../standard/assembly/index.md)
Original file line number Diff line number Diff line change
Expand Up @@ -31,4 +31,4 @@ This new behavior is the default for intranet assemblies. You can return to the

## See also

- [Programming with Assemblies](../../standard/assembly/program.md)
- [Programming with Assemblies](../../standard/assembly/index.md)
2 changes: 1 addition & 1 deletion docs/framework/app-domains/use.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ Represents an application domain. Provides methods for creating and controlling
[Assemblies in .NET](../../standard/assembly/index.md)
Provides an overview of the functions performed by assemblies.

[Programming with Assemblies](../../standard/assembly/program.md)
[Programming with Assemblies](../../standard/assembly/index.md)
Describes how to create, sign, and set attributes on assemblies.

[Emitting Dynamic Methods and Assemblies](../reflection-and-codedom/emitting-dynamic-methods-and-assemblies.md)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -65,5 +65,5 @@ Explains how to use the [Ildasm.exe (IL Disassembler)](../tools/ildasm-exe-il-di
[How the Runtime Locates Assemblies](../deployment/how-the-runtime-locates-assemblies.md)
Describes how the common language runtime locates and loads the assemblies that make up your application.

[Programming with Assemblies](../../standard/assembly/program.md)
[Programming with Assemblies](../../standard/assembly/index.md)
Describes assemblies, the building blocks of managed applications.
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ Specifies whether the runtime creates <xref:System.Security.Policy.Publisher> ev
## Remarks

> [!NOTE]
> In the .NET Framework 4 and later, this element has no effect on assembly load times. For more information, see the "Security Policy Simplification" section in [Security Changes](../../../security/security-changes.md).
> In the .NET Framework 4 and later, this element has no effect on assembly load times. For more information, see the "Security Policy Simplification" section in [Security Changes](https://docs.microsoft.com/previous-versions/dotnet/framework/security/security-changes).

The common language runtime (CLR) tries to verify the Authenticode signature at load time to create <xref:System.Security.Policy.Publisher> evidence for the assembly. However, by default, most applications do not need <xref:System.Security.Policy.Publisher> evidence. Standard CAS policy does not rely on the <xref:System.Security.Policy.PublisherMembershipCondition>. You should avoid the unnecessary startup cost associated with verifying the publisher signature unless your application executes on a computer with custom CAS policy, or is intending to satisfy demands for <xref:System.Security.Permissions.PublisherIdentityPermission> in a partial-trust environment. (Demands for identity permissions always succeed in a full-trust environment.)

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ Registers a cache for session tokens with a service or a security token handler
|[\<caches>](caches.md)|Registers the caches used by a service or a security token handler collection.|

## Example
The following XML shows the configuration of a custom cache for holding session security tokens (<xref:System.IdentityModel.Tokens.SessionSecurityToken>). The configuration is taken from the `ClaimsAwareWebFarm` sample. For more information about this sample, see [WIF Code Sample Index](../../../security/wif-code-sample-index.md).
The following XML shows the configuration of a custom cache for holding session security tokens (<xref:System.IdentityModel.Tokens.SessionSecurityToken>). The configuration is taken from the `ClaimsAwareWebFarm` sample. For more information about this sample, see [WIF Code Sample Index](https://docs.microsoft.com/previous-versions/dotnet/framework/security/wif-code-sample-index).

```xml
<caches>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -103,7 +103,7 @@ gacutil /i policy.1.0.myAssembly.dll

## See also

- [Programming with Assemblies](../../standard/assembly/program.md)
- [Programming with Assemblies](../../standard/assembly/index.md)
- [How the Runtime Locates Assemblies](../deployment/how-the-runtime-locates-assemblies.md)
- [Configuring Apps by using Configuration Files](index.md)
- [Runtime Settings Schema](./file-schema/runtime/index.md)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -152,7 +152,7 @@ You can enable automatic binding redirection if your app targets older versions
- [\<bindingRedirect> Element](./file-schema/runtime/bindingredirect-element.md)
- [Assembly Binding Redirection Security Permission](assembly-binding-redirection-security-permission.md)
- [Assemblies in .NET](../../standard/assembly/index.md)
- [Programming with Assemblies](../../standard/assembly/program.md)
- [Programming with Assemblies](../../standard/assembly/index.md)
- [How the Runtime Locates Assemblies](../deployment/how-the-runtime-locates-assemblies.md)
- [Configuring Apps](index.md)
- [Runtime Settings Schema](./file-schema/runtime/index.md)
Expand Down
2 changes: 1 addition & 1 deletion docs/framework/configure-apps/specify-assembly-location.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,6 +62,6 @@ There are two ways to specify an assembly's location:
## See also

- [Assemblies in .NET](../../standard/assembly/index.md)
- [Programming with Assemblies](../../standard/assembly/program.md)
- [Programming with Assemblies](../../standard/assembly/index.md)
- [How the Runtime Locates Assemblies](../deployment/how-the-runtime-locates-assemblies.md)
- [Configuring Apps by using Configuration Files](index.md)
2 changes: 1 addition & 1 deletion docs/framework/data/adonet/code-access-security.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ The .NET Framework offers role-based security as well as code access security (C
Depending on the type of application you are building, you should also consider implementing role-based permissions in the database. For more information on role-based security in SQL Server, see [SQL Server Security](./sql/sql-server-security.md).

## Assemblies
Assemblies form the fundamental unit of deployment, version control, reuse, activation scoping, and security permissions for a .NET Framework application. An assembly provides a collection of types and resources that are built to work together and form a logical unit of functionality. To the CLR, a type does not exist outside the context of an assembly. For more information on creating and deploying assemblies, see [Programming with Assemblies](../../../standard/assembly/program.md).
Assemblies form the fundamental unit of deployment, version control, reuse, activation scoping, and security permissions for a .NET Framework application. An assembly provides a collection of types and resources that are built to work together and form a logical unit of functionality. To the CLR, a type does not exist outside the context of an assembly. For more information on creating and deploying assemblies, see [Programming with Assemblies](../../../standard/assembly/index.md).

### Strong-naming Assemblies
A strong name, or digital signature, consists of the assembly's identity, which includes its simple text name, version number, and culture information (if provided), plus a public key and a digital signature. The digital signature is generated from an assembly file using the corresponding private key. The assembly file contains the assembly manifest, which contains the names and hashes of all the files that make up the assembly.
Expand Down
6 changes: 3 additions & 3 deletions docs/framework/data/adonet/ef/terminology.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ This topic defines terms frequently referenced in Entity Framework documentation
|ComplexType|The specification for a data type that represents a non-scalar property of an entity type that does not have a key property.<br /><br /> For more information, see [ComplexType Element (CSDL)](/ef/ef6/modeling/designer/advanced/edmx/csdl-spec#complextype-element-csdl) and [complex type](../complex-type.md).|
|conceptual model|An abstract specification for the entity types, complex types, associations, entity containers, entity sets, and association sets in the domain of an application in the Entity Framework. The conceptual model is defined in CSDL in the .csdl file.<br /><br /> For more information, see [Modeling and Mapping](modeling-and-mapping.md).|
|.csdl file|An XML file that contains the conceptual model, expressed in CSDL.|
|conceptual schema definition language (CSDL)|An XML-based language that is used to define the entity types, associations, entity containers, entity sets, and association sets of a conceptual model.<br /><br /> For more information, see [CSDL Specification](./language-reference/csdl-specification.md).|
|conceptual schema definition language (CSDL)|An XML-based language that is used to define the entity types, associations, entity containers, entity sets, and association sets of a conceptual model.<br /><br /> For more information, see [CSDL Specification](/ef/ef6/modeling/designer/advanced/edmx/csdl-spec).|
|container|A logical grouping of entity and association sets.<br /><br /> For more information, see [EntityContainer Element (CSDL)](/ef/ef6/modeling/designer/advanced/edmx/csdl-spec#entitycontainer-element-csdl) and [entity container](../entity-container.md).|
|concurrency|A process that allows multiple users to access and change shared data at the same time. By default, the Entity Framework implements an optimistic concurrency model.|
|direction|Refers to the asymmetrical nature of some associations. Direction is specified with `FromRole` and `ToRole` attributes of a `NavigationProperty` or `ReferentialConstraint` element in a schema.<br /><br /> For more information, see [NavigationProperty Element (CSDL)](/ef/ef6/modeling/designer/advanced/edmx/csdl-spec#navigationproperty-element-csdl) and [navigation property](../navigation-property.md).|
Expand All @@ -39,9 +39,9 @@ This topic defines terms frequently referenced in Entity Framework documentation
|key|The attribute of an entity type that specifies which property or set of properties is used to identify unique instances of the entity type. Represented in the object layer by the <xref:System.Data.EntityKey> class.<br /><br /> For more information, see [Key Element (CSDL)](/ef/ef6/modeling/designer/advanced/edmx/csdl-spec#key-element-csdl) and [entity key](../entity-key.md).|
|lazy loading|When objects are returned by a query, related objects are not loaded at the same time. Instead they are loaded automatically when the navigation property is accessed.|
|LINQ to Entities|A query syntax that defines a set of query operators that allow traversal, filter, and projection operations to be expressed in a direct, declarative way in Visual C# and Visual Basic.<br /><br /> For more information, see [LINQ to Entities](./language-reference/linq-to-entities.md).|
|mapping|A specification of the correspondences between items in a conceptual model and items in a storage model.<br /><br /> For more information, see [MSL Specification](./language-reference/msl-specification.md).|
|mapping|A specification of the correspondences between items in a conceptual model and items in a storage model.<br /><br /> For more information, see [MSL Specification](/ef/ef6/modeling/designer/advanced/edmx/msl-spec).|
|.msl file|An XML file that contains the mapping between the conceptual model and the storage model, expressed in MSL.|
|mapping specification language (MSL)|An XML-based language that is used to map items defined in a conceptual model to items in a storage model.<br /><br /> For more information, see [MSL Specification](./language-reference/msl-specification.md).|
|mapping specification language (MSL)|An XML-based language that is used to map items defined in a conceptual model to items in a storage model.<br /><br /> For more information, see [MSL Specification](/ef/ef6/modeling/designer/advanced/edmx/msl-spec).|
|modification functions|Stored procedures that are used to insert, update, and delete data that is in the data source. These functions are used in place of Entity Framework generated commands. Modification functions are defined by the `Function` element in the storage model. The [ModificationFunctionMapping](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/cc716778(v=vs.100)) element maps these modification functions to insert, update, and delete operations against entities that are defined in the conceptual model.|
|multiplicity|The number of entities that can exist on each side of a relationship, as defined by an association. Also known as cardinality.<br /><br /> For more information, see [End Element (CSDL)](/ef/ef6/modeling/designer/advanced/edmx/csdl-spec#end-element-csdl) and [association end](../association-end.md).|
|multiple entity sets per type|The ability for an entity type to be defined in more than one entity set.<br /><br /> For more information, see [EntitySet Element (CSDL)](/ef/ef6/modeling/designer/advanced/edmx/csdl-spec#entityset-element-csdl) and [How to: Define a Model with Multiple Entity Sets per Type](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/bb738537(v=vs.100)).|
Expand Down
7 changes: 3 additions & 4 deletions docs/framework/development-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,12 +5,11 @@ helpviewer_keywords:
- ".NET Framework, development guide"
ms.assetid: 26e3d285-24c3-435c-a797-9fe5affb8525
---
# .NET Framework Development Guide
# .NET Framework development guide

This section explains how to create, configure, debug, secure, and deploy your .NET Framework apps. The section also provides information about technology areas such as dynamic programming, interoperability, extensibility, memory management, and threading.

## In This Section
[Application Essentials](../standard/application-essentials.md)
Provides information about basic app development tasks, such as programming with app domains and assemblies, using attributes, formatting and parsing base types, using collections, handling events and exceptions, using files and data streams, and using generics.
## In This Section

[Data and Modeling](./data/index.md)
Provides information about how to access data using ADO.NET, Language Integrated Query (LINQ), WCF Data Services, and XML.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -38,5 +38,4 @@ Starting with apps that target the .NET Framework 4.6.1, the path separator used

## See also

- [Retargeting Changes](retargeting-changes-in-the-net-framework-4-6-1.md)
- [Application compatibility](application-compatibility.md)
Loading