Azure / azure-cosmos-dotnet-v2

Contains samples and utilities relating to the Azure Cosmos DB .NET SDK
MIT License
577 stars 838 forks source link

Document behavior of Resouce.GetPropertyValue<T>(string) when property does not exist #834

Open chwarr opened 6 years ago

chwarr commented 6 years ago

The documentation for Microsoft.Azure.Documents.Resource.GetPropertyValue<T>(string) needs to have explicit documentation about what the behavior is when the property doesn't exist.

Decompiling "microsoft.azure.documentdb.core\1.9.1\lib\netstandard1.6\Microsoft.Azure.DocumentDB.Core.dll" it looks like default(T) is returned.


Document Details

Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

ghost commented 3 years ago

Thanks for the feedback! We are routing this to the appropriate team for follow-up. cc @Wmengmsft, @MehaKaushik, @shurd

ghost commented 3 years ago

Thanks for the feedback! We are routing this to the appropriate team for follow-up. cc @Wmengmsft, @MehaKaushik, @shurd.

Issue Details
The documentation for `Microsoft.Azure.Documents.Resource.GetPropertyValue(string)` needs to have explicit documentation about what it's behavior is when the property doesn't exist. Decompiling "microsoft.azure.documentdb.core\1.9.1\lib\netstandard1.6\Microsoft.Azure.DocumentDB.Core.dll" it looks like `default(T)` is returned. --- #### Document Details ⚠ *Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.* * ID: ad93686e-ec60-9a23-5c5c-4cd4bb8086b4 * Version Independent ID: 6248b401-751b-57e0-3cfb-eed086dfacd0 * Content: [Resource.GetPropertyValue(String) Method (Microsoft.Azure.Documents)](https://docs.microsoft.com/en-us/dotnet/api/microsoft.azure.documents.resource.getpropertyvalue?view=azure-dotnet#Microsoft_Azure_Documents_Resource_GetPropertyValue__1_System_String_) * Content Source: [xml/Microsoft.Azure.Documents/Resource.xml](https://github.com/Azure/azure-docs-sdk-dotnet/blob/master/xml/Microsoft.Azure.Documents/Resource.xml) * Service: **cosmos-db** * GitHub Login: @CamSoper * Microsoft Alias: **casoper**
Author: chwarr
Assignees: -
Labels: `Client`, `Cosmos`, `Docs`, `Service Attention`, `needs-team-attention`, `needs-triage`
Milestone: -