MicrosoftDocs / winrt-api

WinRT reference content for developing Microsoft Universal Windows Platform (UWP) apps
Creative Commons Attribution 4.0 International
227 stars 493 forks source link

StorageItemContentProperties sample is not a sample #2451

Closed SamHobbsOrg closed 4 months ago

SamHobbsOrg commented 5 months ago

The sample code in the page is not a code sample of StorageItemContentProperties, right?


Document Details

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

alvinashcraft commented 4 months ago

Hi @SamHobbsOrg. The StorageItemContentProperties class is being used in the sample on this page. The Properties object on this line is of that type:

IDictionary<string, object> extraProperties = await file.Properties.RetrievePropertiesAsync(propertiesName);

Is there some other use of the type that you were looking for? You can try the sample yourself at the link provided on that page. https://github.com/microsoft/Windows-universal-samples/tree/main/Samples/FileAccess/cs

If you believe your feedback is still actionable, let us know either directly in this thread or by filing a new Issue and we’ll work to incorporate the suggestions into the documentation. Though the Issue will be marked as Closed, we will monitor any replies that come afterwards so feel free to treat this like an open Issue. Many thanks!

SamHobbsOrg commented 4 months ago

I am sure that what you say makes sense to you but it definitely does not make sense to me. I do not understand how the StorageItemContentProperties class is relevant. When I look at the definition of RetrievePropertiesAsync I see:

public IAsyncOperation<IDictionary<string, object>> RetrievePropertiesAsync(IEnumerable<string> propertiesToRetrieve)
{
    return IStorageItemExtraPropertiesMethods.RetrievePropertiesAsync(_objRef_global__Windows_Storage_FileProperties_IStorageItemExtraProperties, propertiesToRetrieve);
}

I see no use of the StorageItemContentProperties class. I think the documentation should explain how the sample uses the class.