search

MicrosoftDocs / azure-docs

Open source documentation of Microsoft Azure
https://docs.microsoft.com/azure
Creative Commons Attribution 4.0 International
10.28k stars 21.46k forks source link

MessageSender output parameter type is undocumented #65646

Open creyke opened 4 years ago

creyke commented 4 years ago

When opting to use parameters as opposed to a return type, the only options documented in the Usage section are ICollector<T> and IAsyncCollector<T>.

These collectors serialize T to a byte array in the message body but do not provide access to the message metadata elements such as the properties PartitionKey and MessageId. Write access to the metadata is required when using for example deduplication and other features.

MessageSender is a valid alternative output parameter and resolves this impasse, but it is completely undocumented, and can only be found through time consuming trial and error.

Document Details

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

ChaitanyaNaykodi-MSFT commented 4 years ago

Hello @creyke, Thank you for your feedback! We have assigned this issue to the author to review further and take the next course of action.