Skip to content

Commit ab622e6

Browse files
author
Ron Petrusha
authored
Added note recommending .NET Standard (#6541)
* Added note recommending .NET Standard * Corrected case of 'We'
1 parent c3ec672 commit ab622e6

File tree

5 files changed

+18
-7
lines changed

5 files changed

+18
-7
lines changed

docs/standard/cross-platform/app-resources-for-libraries-that-target-multiple-platforms.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: "App Resources for Libraries That Target Multiple Platforms"
3-
ms.date: "03/30/2017"
3+
ms.date: "07/18/2018"
44
ms.technology: dotnet-standard
55
dev_langs:
66
- "csharp"
@@ -17,6 +17,8 @@ ms.author: "mairaw"
1717
---
1818
# App Resources for Libraries That Target Multiple Platforms
1919
You can use the .NET Framework [Portable Class Library](../../../docs/standard/cross-platform/cross-platform-development-with-the-portable-class-library.md) project type to ensure that resources in your class libraries can be accessed from multiple platforms. This project type is available in [!INCLUDE[vs_dev11_long](../../../includes/vs-dev11-long-md.md)] and targets the portable subset of the .NET Framework class library. Using a [!INCLUDE[net_portable](../../../includes/net-portable-md.md)] ensures that your library can be accessed from desktop apps, Silverlight apps, Windows Phone apps, and [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] apps.
20+
21+
[!INCLUDE[standard](../../../includes/pcl-to-standard.md)]
2022

2123
The [!INCLUDE[net_portable](../../../includes/net-portable-md.md)] project makes only a very limited subset of the types in the <xref:System.Resources> namespace available to your application, but it does allow you to use the <xref:System.Resources.ResourceManager> class to retrieve resources. However, if you are creating an app by using Visual Studio, you should use the strongly typed wrapper created by Visual Studio instead of using the <xref:System.Resources.ResourceManager> class directly.
2224

docs/standard/cross-platform/cross-platform-development-with-the-portable-class-library.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: "Cross-Platform Development with the Portable Class Library"
3-
ms.date: "03/30/2017"
3+
ms.date: "07/18/2018"
44
ms.technology: dotnet-standard
55
helpviewer_keywords:
66
- "Portable Class Library [.NET Framework]"
@@ -12,7 +12,9 @@ ms.author: "mairaw"
1212
---
1313
# Cross-Platform Development with the Portable Class Library
1414
The .NET Framework Portable Class Library project type in Visual Studio helps you build cross-platform apps and libraries for Microsoft platforms quickly and easily.
15-
15+
16+
[!INCLUDE[standard](../../../includes/pcl-to-standard.md)]
17+
1618
Portable class libraries can help you reduce the time and costs of developing and testing code. Use this project type to write and build portable .NET Framework assemblies, and then reference those assemblies from apps that target multiple platforms such as Windows and Windows Phone.
1719

1820
Even after you create a Portable Class Library project in Visual Studio and start developing it, you can change the target platforms. Visual Studio will compile your library with the new assemblies, which helps you identify the changes you need to make in your code.

docs/standard/cross-platform/index.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: "Developing for Multiple Platforms with the .NET Framework"
3-
ms.date: "03/30/2017"
3+
ms.date: "07/18/2018"
44
ms.technology: dotnet-standard
55
ms.assetid: b153baaa-130c-4169-860b-e580591de91e
66
author: "mairaw"
@@ -9,7 +9,10 @@ ms.author: "mairaw"
99
# Developing for Multiple Platforms with the .NET Framework
1010
You can develop apps for both Microsoft and non-Microsoft platforms by using the .NET Framework and Visual Studio.
1111

12-
## Options for cross-platform development
12+
## Options for cross-platform development
13+
14+
[!INCLUDE[standard](../../../includes/pcl-to-standard.md)]
15+
1316
To develop for multiple platforms, you can share source code or binaries, and you can make calls between .NET Framework code and Windows Runtime APIs.
1417

1518
|If you want to...|Use...|

docs/standard/cross-platform/using-portable-class-library-with-model-view-view-model.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: "Using Portable Class Library with Model-View-View Model"
3-
ms.date: "03/30/2017"
3+
ms.date: "07/18/2018"
44
ms.technology: dotnet-standard
55
dev_langs:
66
- "csharp"
@@ -14,7 +14,9 @@ ms.author: "mairaw"
1414
---
1515
# Using Portable Class Library with Model-View-View Model
1616
You can use the .NET Framework [Portable Class Library](../../../docs/standard/cross-platform/cross-platform-development-with-the-portable-class-library.md) to implement the Model-View-View Model (MVVM) pattern and share assemblies across multiple platforms.
17-
17+
18+
[!INCLUDE[standard](../../../includes/pcl-to-standard.md)]
19+
1820
MVVM is an application pattern that isolates the user interface from the underlying business logic. You can implement the model and view model classes in a [!INCLUDE[net_portable](../../../includes/net-portable-md.md)] project in [!INCLUDE[vs_dev11_long](../../../includes/vs-dev11-long-md.md)], and then create views that are customized for different platforms. This approach enables you to write the data model and business logic only once, and use that code from .NET Framework, Silverlight, Windows Phone, and [!INCLUDE[win8_appname_long](../../../includes/win8-appname-long-md.md)] apps, as shown in the following illustration.
1921

2022
![Portable with MVVM diagram](../../../docs/standard/cross-platform/media/portablemvvmdiagram.png "PortableMVVMdiagram")

includes/pcl-to-standard.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
> [!IMPORTANT]
2+
> Because Portable Class Library projects target only a very specific subset of .NET implementations, we strongly discourage their use in new application development. The recommended replacement is a .NET Standard library, which targets all .NET implementations that support a specific version of the .NET Standard. For more information, see [.NET Standard](~/docs/standard/net-standard.md).

0 commit comments

Comments
 (0)