Azure-docs: SetMetadata/SetMetadataAsync do not allow newline characters ('\n')

[TracyGH]

In Azure Storage Explorer, I can assign a newline character ('n') to a blob Metadata value without any issues. However, when I call cloudBlockBlob.SetMetadata() or cloudBlockBlob.SetMetadataAsync() with a value containing the newline character, it fails.

Someone else reproduced the same issue in this SO thread, but the documentation referenced in one of the comments does not exist anymore.

The current documentation indicates that any ASCII characters should work for Metadata values, and a backslash and 'n' would both be considered valid ASCII characters.

---

Document Details

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

• ID: 84ac5495-fab7-02a9-37d9-dde1e463cb4a
• Version Independent ID: 48fc73ee-bb7a-6175-e962-31731b795d31
• Content: Set and retrieve object properties and metadata in Azure Storage
• Content Source: articles/storage/blobs/storage-properties-metadata.md
• Service: storage
• GitHub Login: @tamram
• Microsoft Alias: tamram

[AdamS-MSFT]

Hi @TracyGH ,

What specific Azure Storage library version are you using when getting this error message ?
The list of Libraries and newest versions can be found here , Let me know if you are using the latest then i'll route it as a doc/product issue.

Thanks,
Adam

[TracyGH]

@Adam-Smith-MSFT

[tamram]

Thank you, @TracyGH, I have confirmed with the Azure Storage engineering team that this is a bug in the SDK. They are tracking the issue and will address it in a future release. I'll update this issue once it's fixed.

@Adam-Smith-MSFT - FYI.

please-close

[gojanpaolo]

@tamram @Adam-Smith-MSFT Adding metadata using CloudBlockBlob.Metadata.Add also throws exception upon uploading the blob when the value contains any of the following characters:

• \r
• \n
• \r\n

Thanks!

[tamram]

@gojanpaolo - Thank you, I will let the engineering team know.