AWS SDK Version 4 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Creates an exact match condition that requires a form field to have exactly the specified value.

Namespace: Amazon.S3.Model
Assembly: AWSSDK.S3.dll
Version: 3.x.y.z

Syntax

C# 
public ExactMatchCondition ExactMatch(
         String fieldName,
         String expectedValue
)

Parameters

fieldName
Type: System.String

The name of the form field that must match the expected value. Common field names include "bucket", "acl", "Content-Type", and custom metadata fields prefixed with "x-amz-meta-".

expectedValue
Type: System.String

The exact value that the form field must have for the upload to be allowed.

Return Value


Type: ExactMatchCondition
An for the specified field and value.

Exceptions

ExceptionCondition
System.ArgumentNullException Thrown when or is null.
System.ArgumentException Thrown when or is empty.

Examples

// Require uploads to have public-read ACL
var aclCondition = S3PostCondition.ExactMatch("acl", "public-read");
            
// Require specific content type
var contentTypeCondition = S3PostCondition.ExactMatch("Content-Type", "image/jpeg");

Version Information

.NET:
Supported in: 8.0 and newer, Core 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.7.2 and newer