Sztringfüggvények ARM-sablonokhoz

Cikk
02/01/2024

A Resource Manager az alábbi függvényeket biztosítja az Azure Resource Manager-sablonban (ARM-sablonban) található sztringek kezeléséhez:

base64
base64ToJson
base64ToString
Concat
Tartalmaz
dataUri
dataUriToString
Üres
endsWith
Első
format
Guid
indexOf
csatlakozás
Json
Utolsó
lastIndexOf
length (hossz)
newGuid
padLeft
Helyettesít
Ugrál
hasít
startsWith
húr
Substring
take
toLower
toUpper
Berendezés
uniqueString
Uri
uriComponent
uriComponentToString

Tipp.

A Bicep használatát javasoljuk, mert ugyanazokkal a képességekkel rendelkezik, mint az ARM-sablonok, és a szintaxis használata egyszerűbb. További információ: sztringfüggvények.

base64

base64(inputString)

A bemeneti sztring base64-ábrázolását adja vissza.

A Bicepben használja a base64 függvényt.

Paraméterek

Paraméter	Szükséges	Típus	Leírás
inputString	Igen	húr	A base64-ábrázolásként visszaadandó érték.

Visszaadott érték

A base64-ábrázolást tartalmazó sztring.

Példák

Az alábbi példa a függvény használatát base64 mutatja be.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "stringData": {
      "type": "string",
      "defaultValue": "one, two, three"
    },
    "jsonFormattedData": {
      "type": "string",
      "defaultValue": "{'one': 'a', 'two': 'b'}"
    }
  },
  "variables": {
    "base64String": "[base64(parameters('stringData'))]",
    "base64Object": "[base64(parameters('jsonFormattedData'))]"
  },
  "resources": [
  ],
  "outputs": {
    "base64Output": {
      "type": "string",
      "value": "[variables('base64String')]"
    },
    "toStringOutput": {
      "type": "string",
      "value": "[base64ToString(variables('base64String'))]"
    },
    "toJsonOutput": {
      "type": "object",
      "value": "[base64ToJson(variables('base64Object'))]"
    }
  }
}

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
base64Output	Sztring	b25lLCB0d28sIHRocmVl
toStringOutput	Sztring	egy két há'
toJsonOutput	Objektum	{"one": "a", "two": "b"}

base64ToJson

base64ToJson(base64Value)

A base64-ábrázolás JSON-objektummá alakít át.

A Bicepben használja a base64ToJson függvényt.

Paraméterek

Paraméter	Szükséges	Típus	Leírás
base64Value	Igen	húr	A JSON-objektummá alakítandó base64-ábrázolás.

Visszaadott érték

JSON-objektum.

Példák

Az alábbi példa a függvényt használja egy base64ToJson base64-érték konvertálásához:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "stringData": {
      "type": "string",
      "defaultValue": "one, two, three"
    },
    "jsonFormattedData": {
      "type": "string",
      "defaultValue": "{'one': 'a', 'two': 'b'}"
    }
  },
  "variables": {
    "base64String": "[base64(parameters('stringData'))]",
    "base64Object": "[base64(parameters('jsonFormattedData'))]"
  },
  "resources": [
  ],
  "outputs": {
    "base64Output": {
      "type": "string",
      "value": "[variables('base64String')]"
    },
    "toStringOutput": {
      "type": "string",
      "value": "[base64ToString(variables('base64String'))]"
    },
    "toJsonOutput": {
      "type": "object",
      "value": "[base64ToJson(variables('base64Object'))]"
    }
  }
}

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
base64Output	Sztring	b25lLCB0d28sIHRocmVl
toStringOutput	Sztring	egy két há'
toJsonOutput	Objektum	{"one": "a", "two": "b"}

base64ToString

base64ToString(base64Value)

Egy base64-ábrázolás sztringgé alakít át.

A Bicepben használja a base64ToString függvényt .

Paraméterek

Paraméter	Szükséges	Típus	Leírás
base64Value	Igen	húr	A sztringgé alakítandó base64-ábrázolás.

Visszaadott érték

A konvertált base64 érték sztringje.

Példák

Az alábbi példa a függvényt használja egy base64ToString base64-érték konvertálásához:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "stringData": {
      "type": "string",
      "defaultValue": "one, two, three"
    },
    "jsonFormattedData": {
      "type": "string",
      "defaultValue": "{'one': 'a', 'two': 'b'}"
    }
  },
  "variables": {
    "base64String": "[base64(parameters('stringData'))]",
    "base64Object": "[base64(parameters('jsonFormattedData'))]"
  },
  "resources": [
  ],
  "outputs": {
    "base64Output": {
      "type": "string",
      "value": "[variables('base64String')]"
    },
    "toStringOutput": {
      "type": "string",
      "value": "[base64ToString(variables('base64String'))]"
    },
    "toJsonOutput": {
      "type": "object",
      "value": "[base64ToJson(variables('base64Object'))]"
    }
  }
}

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
base64Output	Sztring	b25lLCB0d28sIHRocmVl
toStringOutput	Sztring	egy két há'
toJsonOutput	Objektum	{"one": "a", "two": "b"}

összefűzés

concat(arg1, arg2, arg3, ...)

Több sztringértéket egyesít, és visszaadja az összefűzött sztringet, vagy több tömböt egyesít, és visszaadja az összefűzött tömböt.

A Bicepben a függvény helyett sztringinterpolációt használjon az concat() olvashatóság javítása érdekében. Bizonyos esetekben azonban, például a többsoros sztringek sztringcseréje esetén előfordulhat, hogy vissza kell esnie a függvény vagy areplace()concat()függvény használatára.

Paraméterek

Paraméter	Szükséges	Típus	Leírás
arg1	Igen	sztring vagy tömb	Az összefűzés első sztringje vagy tömbje.
további argumentumok	Nem	sztring vagy tömb	További sztringek vagy tömbök szekvenciális sorrendben az összefűzéshez.

Ez a függvény tetszőleges számú argumentumot tartalmazhat, és sztringeket vagy tömböket is elfogadhat a paraméterekhez. A paraméterekhez azonban nem adhat meg tömböket és sztringeket. A sztringek csak más sztringekkel vannak összefűzve.

Visszaadott érték

Összefűzött értékek sztringje vagy tömbje.

Példák

Az alábbi példa bemutatja, hogyan kombinálhat két sztringértéket, és hogyan ad vissza egy összefűzött sztringet.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "prefix": {
      "type": "string",
      "defaultValue": "prefix"
    }
  },
  "resources": [],
  "outputs": {
    "concatOutput": {
      "type": "string",
      "value": "[concat(parameters('prefix'), '-', uniqueString(resourceGroup().id))]"
    }
  }
}

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
concatOutput	Sztring	előtag-5yj4yjf5mbg72

Az alábbi példa bemutatja, hogyan kombinálhat két tömböt.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "firstArray": {
      "type": "array",
      "defaultValue": [
        "1-1",
        "1-2",
        "1-3"
      ]
    },
    "secondArray": {
      "type": "array",
      "defaultValue": [
        "2-1",
        "2-2",
        "2-3"
      ]
    }
  },
  "resources": [
  ],
  "outputs": {
    "return": {
      "type": "array",
      "value": "[concat(parameters('firstArray'), parameters('secondArray'))]"
    }
  }
}

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
vissza	Tömb	["1-1", "1-2", "1-3", "2-1", "2-2", "2-3"]

contains

contains(container, itemToFind)

Ellenőrzi, hogy egy tömb tartalmaz-e értéket, egy objektum tartalmaz-e kulcsot, vagy egy sztring tartalmaz-e részsztringet. A sztringek összehasonlítása megkülönbözteti a kis- és nagybetűk értékét. Ha azonban egy objektum tartalmaz kulcsot, az összehasonlítás érzéketlen.

A Bicepben használja a contains függvényt.

Paraméterek

Paraméter	Szükséges	Típus	Leírás
tároló	Igen	tömb, objektum vagy sztring	A keresendő értéket tartalmazó érték.
itemToFind	Igen	sztring vagy int	A keresendő érték.

Visszaadott érték

Igaz , ha az elem megtalálható; ellenkező esetben Hamis.

Példák

Az alábbi példa bemutatja, hogyan használható különböző típusú:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "stringToTest": {
      "type": "string",
      "defaultValue": "OneTwoThree"
    },
    "objectToTest": {
      "type": "object",
      "defaultValue": {
        "one": "a",
        "two": "b",
        "three": "c"
      }
    },
    "arrayToTest": {
      "type": "array",
      "defaultValue": [ "one", "two", "three" ]
    }
  },
  "resources": [
  ],
  "outputs": {
    "stringTrue": {
      "type": "bool",
      "value": "[contains(parameters('stringToTest'), 'e')]"
    },
    "stringFalse": {
      "type": "bool",
      "value": "[contains(parameters('stringToTest'), 'z')]"
    },
    "objectTrue": {
      "type": "bool",
      "value": "[contains(parameters('objectToTest'), 'one')]"
    },
    "objectFalse": {
      "type": "bool",
      "value": "[contains(parameters('objectToTest'), 'a')]"
    },
    "arrayTrue": {
      "type": "bool",
      "value": "[contains(parameters('arrayToTest'), 'three')]"
    },
    "arrayFalse": {
      "type": "bool",
      "value": "[contains(parameters('arrayToTest'), 'four')]"
    }
  }
}

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
stringTrue	Bool	Igaz
stringFalse	Bool	Hamis
objectTrue	Bool	Igaz
objectFalse	Bool	Hamis
arrayTrue	Bool	Igaz
arrayFalse	Bool	Hamis

dataUri

dataUri(stringToConvert)

Egy értéket adat URI-vá alakít át.

A Bicepben használja a dataUri függvényt.

Paraméterek

Paraméter	Szükséges	Típus	Leírás
stringToConvert	Igen	húr	Az adat URI-vá konvertálandó érték.

Visszaadott érték

Adat URI-ként formázott sztring.

Példák

Az alábbi példa egy értéket adat URI-vá konvertál, és egy adat URI-t sztringgé alakít át.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "stringToTest": {
      "type": "string",
      "defaultValue": "Hello"
    },
    "dataFormattedString": {
      "type": "string",
      "defaultValue": "data:;base64,SGVsbG8sIFdvcmxkIQ=="
    }
  },
  "resources": [],
  "outputs": {
    "dataUriOutput": {
      "value": "[dataUri(parameters('stringToTest'))]",
      "type": "string"
    },
    "toStringOutput": {
      "type": "string",
      "value": "[dataUriToString(parameters('dataFormattedString'))]"
    }
  }
}

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
dataUriOutput	Sztring	data:text/plain; charset=utf8; base64,SGVsbG8=
toStringOutput	Sztring	Helló világ!

dataUriToString

dataUriToString(dataUriToConvert)

Az adat URI formátumú értékét sztringgé alakítja át.

A Bicepben használja a dataUriToString függvényt .

Paraméterek

Paraméter	Szükséges	Típus	Leírás
dataUriToConvert	Igen	húr	Az átalakítandó adat URI-értéke.

Visszaadott érték

A konvertált értéket tartalmazó sztring.

Példák

Az alábbi példasablon adat URI-vá konvertálja az értéket, és sztringgé alakítja az adat URI-t.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "stringToTest": {
      "type": "string",
      "defaultValue": "Hello"
    },
    "dataFormattedString": {
      "type": "string",
      "defaultValue": "data:;base64,SGVsbG8sIFdvcmxkIQ=="
    }
  },
  "resources": [],
  "outputs": {
    "dataUriOutput": {
      "value": "[dataUri(parameters('stringToTest'))]",
      "type": "string"
    },
    "toStringOutput": {
      "type": "string",
      "value": "[dataUriToString(parameters('dataFormattedString'))]"
    }
  }
}

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
dataUriOutput	Sztring	data:text/plain; charset=utf8; base64,SGVsbG8=
toStringOutput	Sztring	Helló világ!

üres

empty(itemToTest)

Meghatározza, hogy egy tömb, objektum vagy sztring üres-e.

A Bicepben használja az üres függvényt.

Paraméterek

Paraméter	Szükséges	Típus	Leírás
itemToTest	Igen	tömb, objektum vagy sztring	Az az érték, amely ellenőrzi, hogy üres-e.

Visszaadott érték

Igaz értéket ad vissza, ha az érték üres; ellenkező esetben Hamis.

Példák

Az alábbi példa azt ellenőrzi, hogy egy tömb, objektum és sztring üres-e.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "testArray": {
      "type": "array",
      "defaultValue": []
    },
    "testObject": {
      "type": "object",
      "defaultValue": {}
    },
    "testString": {
      "type": "string",
      "defaultValue": ""
    }
  },
  "resources": [
  ],
  "outputs": {
    "arrayEmpty": {
      "type": "bool",
      "value": "[empty(parameters('testArray'))]"
    },
    "objectEmpty": {
      "type": "bool",
      "value": "[empty(parameters('testObject'))]"
    },
    "stringEmpty": {
      "type": "bool",
      "value": "[empty(parameters('testString'))]"
    }
  }
}

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
arrayEmpty	Bool	Igaz
objectEmpty	Bool	Igaz
stringEmpty	Bool	Igaz

endsWith

endsWith(stringToSearch, stringToFind)

Meghatározza, hogy egy sztring értéke végződik-e. Az összehasonlítás kis- és nagybetűket nem érzékelyítő.

A Bicepben használja a endsWith függvényt .

Paraméterek

Paraméter	Szükséges	Típus	Leírás
stringToSearch	Igen	húr	A keresendő elemet tartalmazó érték.
stringToFind	Igen	húr	A keresendő érték.

Visszaadott érték

Igaz , ha a sztring utolsó karaktere vagy karaktere megegyezik az értékkel, ellenkező esetben Hamis.

Példák

Az alábbi példa a függvények és endsWith a startsWith függvények használatát mutatja be:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [],
  "outputs": {
    "startsTrue": {
      "type": "bool",
      "value": "[startsWith('abcdef', 'ab')]"
    },
    "startsCapTrue": {
      "type": "bool",
      "value": "[startsWith('abcdef', 'A')]"
    },
    "startsFalse": {
      "type": "bool",
      "value": "[startsWith('abcdef', 'e')]"
    },
    "endsTrue": {
      "type": "bool",
      "value": "[endsWith('abcdef', 'ef')]"
    },
    "endsCapTrue": {
      "type": "bool",
      "value": "[endsWith('abcdef', 'F')]"
    },
    "endsFalse": {
      "type": "bool",
      "value": "[endsWith('abcdef', 'e')]"
    }
  }
}

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
startsTrue	Bool	Igaz
startsCapTrue	Bool	Igaz
startsFalse	Bool	Hamis
endsTrue	Bool	Igaz
endsCapTrue	Bool	Igaz
endsFalse	Bool	Hamis

első

first(arg1)

A sztring első karakterét vagy a tömb első elemét adja vissza. Ha üres sztringet ad meg, a függvény üres sztringet eredményez. Üres tömb esetén a függvény visszaadja a függvényt null.

A Bicepben használja az első függvényt.

Paraméterek

Paraméter	Szükséges	Típus	Leírás
arg1	Igen	tömb vagy sztring	Az első elem vagy karakter beolvasásának értéke.

Visszaadott érték

A tömb első elemének karakterlánca, vagy a tömb első elemének típusa (sztring, int, tömb vagy objektum).

Példák

Az alábbi példa bemutatja, hogyan használható az első függvény tömbökkel és sztringekkel.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "arrayToTest": {
      "type": "array",
      "defaultValue": [ "one", "two", "three" ]
    }
  },
  "resources": [
  ],
  "outputs": {
    "arrayOutput": {
      "type": "string",
      "value": "[first(parameters('arrayToTest'))]"
    },
    "stringOutput": {
      "type": "string",
      "value": "[first('One Two Three')]"
    }
  }
}

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
arrayOutput	Sztring	egy
stringOutput	Sztring	O

format

format(formatString, arg1, arg2, ...)

Formázott sztringet hoz létre a bemeneti értékekből.

A Bicepben használja a formátumfüggvényt.

Paraméterek

Paraméter	Szükséges	Típus	Leírás
formatString	Igen	húr	Az összetett formátum sztringje.
arg1	Igen	sztring, egész szám vagy logikai érték	A formázott sztringben szerepeltetni kívánt érték.
további argumentumok	Nem	sztring, egész szám vagy logikai érték	További értékek a formázott sztringben.

Megjegyzések

Ezzel a függvénnyel formázhat egy sztringet a sablonban. Ugyanazokat a formázási beállításokat használja, mint a System.String.Format metódus a .NET-ben.

Példák

Az alábbi példa a formátumfüggvény használatát mutatja be.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "greeting": {
      "type": "string",
      "defaultValue": "Hello"
    },
    "name": {
      "type": "string",
      "defaultValue": "User"
    },
    "numberToFormat": {
      "type": "int",
      "defaultValue": 8175133
    }
  },
  "resources": [
  ],
  "outputs": {
    "formatTest": {
      "type": "string",
      "value": "[format('{0}, {1}. Formatted number: {2:N0}', parameters('greeting'), parameters('name'), parameters('numberToFormat'))]"
    }
  }
}

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
formatTest	Sztring	Üdv, Felhasználó. Formázott szám: 8 175 133

guid

guid(baseString, ...)

A paraméterként megadott értékek alapján globálisan egyedi azonosító formájában hoz létre értéket.

A Bicepben használja a guid függvényt.

Paraméterek

Paraméter	Szükséges	Típus	Leírás
baseString	Igen	húr	A KIVONAT függvényben a GUID létrehozásához használt érték.
szükség szerint további paraméterek	Nem	húr	Az egyediséget meghatározó érték létrehozásához szükség szerint annyi sztringet adhat hozzá.

Megjegyzések

Ez a függvény akkor hasznos, ha globálisan egyedi azonosító formátumú értéket kell létrehoznia. Olyan paraméterértékeket ad meg, amelyek korlátozzák az eredmény egyediségének hatókörét. Megadhatja, hogy a név egyedi legyen-e előfizetésre, erőforráscsoportra vagy üzembe helyezésre.

A visszaadott érték nem véletlenszerű sztring, hanem a paraméterek kivonatfüggvényének eredménye. A visszaadott érték 36 karakter hosszú. Ez nem globálisan egyedi. Ha olyan új GUID-t szeretne létrehozni, amely nem a paraméterek kivonatértékén alapul, használja a newGuid függvényt .

Az alábbi példák bemutatják, hogyan hozhat létre egyedi értéket a gyakran használt szintek guidjaival.

Előfizetésre vonatkozó egyedi hatókör

"[guid(subscription().subscriptionId)]"

Erőforráscsoportra vonatkozó egyedi hatókör

"[guid(resourceGroup().id)]"

Erőforráscsoport üzembe helyezésének egyedi hatóköre

"[guid(resourceGroup().id, deployment().name)]"

A guid függvény implementálja az algoritmust az RFC 4122 §4.3-ából. Az eredeti forrás néhány módosítással megtalálható a GuidUtility-ben.

Visszaadott érték

Globálisan egyedi azonosító formátumban 36 karaktert tartalmazó sztring.

Példák

Az alábbi példa a következő eredményből ad guidvissza eredményeket:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {},
  "variables": {},
  "resources": [],
  "outputs": {
    "guidPerSubscription": {
      "type": "string",
      "value": "[guid(subscription().subscriptionId)]"
    },
    "guidPerResourceGroup": {
      "type": "string",
      "value": "[guid(resourceGroup().id)]"
    },
    "guidPerDeployment": {
      "type": "string",
      "value": "[guid(resourceGroup().id, deployment().name)]"
    }
  }
}

indexOf

indexOf(stringToSearch, stringToFind)

Egy érték első pozícióját adja vissza egy sztringen belül. Az összehasonlítás kis- és nagybetűket nem érzékelyítő.

A Bicepben használja az IndexOf függvényt.

Paraméterek

Paraméter	Szükséges	Típus	Leírás
stringToSearch	Igen	húr	A keresendő elemet tartalmazó érték.
stringToFind	Igen	húr	A keresendő érték.

Visszaadott érték

Egy egész szám, amely a keresendő elem pozícióját jelöli. Az érték nulla alapú. Ha az elem nem található, a rendszer a -1 értéket adja vissza.

Példák

Az alábbi példa a függvények és lastIndexOf a indexOf függvények használatát mutatja be:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [],
  "outputs": {
    "firstT": {
      "type": "int",
      "value": "[indexOf('test', 't')]"
    },
    "lastT": {
      "type": "int",
      "value": "[lastIndexOf('test', 't')]"
    },
    "firstString": {
      "type": "int",
      "value": "[indexOf('abcdef', 'CD')]"
    },
    "lastString": {
      "type": "int",
      "value": "[lastIndexOf('abcdef', 'AB')]"
    },
    "notFound": {
      "type": "int",
      "value": "[indexOf('abcdef', 'z')]"
    }
  }
}

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
firstT	Int	0
lastT	Int	3
firstString	Int	2
lastString	Int	0
notFound	Int	1-

Csatlakozás

join(inputArray, delimiter)

Egy sztringtömböt egyetlen sztringbe illeszt, elválasztójellel elválasztva.

A Bicepben használja az illesztés függvényt.

Paraméterek

Paraméter	Szükséges	Típus	Leírás
inputArray	Igen	sztringek tömbje	Összekapcsolandó sztringtömb.
Határoló	Igen	A sztring felosztásához használandó elválasztó.

Visszaadott érték

Egy sztring.

Példák

Az alábbi példa a bemeneti sztringtömböt különböző elválasztójelekkel tagolt sztringekké alakítja.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "variables": {
    "arrayString": [
      "one",
      "two",
      "three"
    ]
  },
  "resources": [],
  "outputs": {
    "firstOutput": {
      "type": "string",
      "value": "[join(variables('arrayString'), ',')]"
    },
    "secondOutput": {
      "type": "string",
      "value": "[join(variables('arrayString'), ';')]"
    }
  }
}

Az előző példa kimenete a következő:

Név	Típus	Érték
firstOutput	Sztring	"egy,kettő,három"
secondOutput	Sztring	"egy; Két; három"

json

json(arg1)

Egy érvényes JSON-sztringet JSON-adattípussá alakít át. További információ: json függvény.

A Bicepben használja a json függvényt.

utolsó

last(arg1)

A sztring utolsó karakterét vagy a tömb utolsó elemét adja vissza.

A Bicepben használja az utolsó függvényt.

Paraméterek

Paraméter	Szükséges	Típus	Leírás
arg1	Igen	tömb vagy sztring	Az utolsó elem vagy karakter beolvasásának értéke.

Visszaadott érték

Egy tömb utolsó elemének utolsó karakterének vagy típusának (sztring, int, tömb vagy objektum) karakterlánca.

Példák

Az alábbi példa bemutatja, hogyan használhatja a last függvényt tömbökkel és sztringekkel.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "arrayToTest": {
      "type": "array",
      "defaultValue": [ "one", "two", "three" ]
    }
  },
  "resources": [
  ],
  "outputs": {
    "arrayOutput": {
      "type": "string",
      "value": "[last(parameters('arrayToTest'))]"
    },
    "stringOutput": {
      "type": "string",
      "value": "[last('One Two Three')]"
    }
  }
}

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
arrayOutput	Sztring	három
stringOutput	Sztring	e

lastIndexOf

lastIndexOf(stringToSearch, stringToFind)

Egy karakterláncon belüli érték utolsó pozícióját adja vissza. Az összehasonlítás kis- és nagybetűket nem érzékelyítő.

A Bicepben használja az utolsóIndexOf függvényt.

Paraméterek

Paraméter	Szükséges	Típus	Leírás
stringToSearch	Igen	húr	A keresendő elemet tartalmazó érték.
stringToFind	Igen	húr	A keresendő érték.

Visszaadott érték

Egy egész szám, amely a megkeresendő elem utolsó pozícióját jelöli. Az érték nulla alapú. Ha az elem nem található, a rendszer a -1 értéket adja vissza.

Példák

Az alábbi példa a függvények és lastIndexOf a indexOf függvények használatát mutatja be:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [],
  "outputs": {
    "firstT": {
      "type": "int",
      "value": "[indexOf('test', 't')]"
    },
    "lastT": {
      "type": "int",
      "value": "[lastIndexOf('test', 't')]"
    },
    "firstString": {
      "type": "int",
      "value": "[indexOf('abcdef', 'CD')]"
    },
    "lastString": {
      "type": "int",
      "value": "[lastIndexOf('abcdef', 'AB')]"
    },
    "notFound": {
      "type": "int",
      "value": "[indexOf('abcdef', 'z')]"
    }
  }
}

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
firstT	Int	0
lastT	Int	3
firstString	Int	2
lastString	Int	0
notFound	Int	1-

length (hossz)

length(string)

Visszaadja egy sztring karaktereinek számát, egy tömb elemeit vagy egy objektum gyökérszintű tulajdonságait.

A Bicepben használja a hosszfüggvényt.

Paraméterek

Paraméter	Szükséges	Típus	Leírás
arg1	Igen	tömb, sztring vagy objektum	Az elemek számának lekéréséhez használandó tömb, a karakterek számának lekéréséhez használandó sztring vagy a gyökérszintű tulajdonságok számának lekéréséhez használni kívánt objektum.

Visszaadott érték

Egy int.

Példák

Az alábbi példa bemutatja, hogyan használható a length függvény tömbökkel és sztringekkel:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "arrayToTest": {
      "type": "array",
      "defaultValue": [
        "one",
        "two",
        "three"
      ]
    },
    "stringToTest": {
      "type": "string",
      "defaultValue": "One Two Three"
    },
    "objectToTest": {
      "type": "object",
      "defaultValue": {
        "propA": "one",
        "propB": "two",
        "propC": "three",
        "propD": {
          "propD-1": "sub",
          "propD-2": "sub"
        }
      }
    }
  },
  "resources": [],
  "outputs": {
    "arrayLength": {
      "type": "int",
      "value": "[length(parameters('arrayToTest'))]"
    },
    "stringLength": {
      "type": "int",
      "value": "[length(parameters('stringToTest'))]"
    },
    "objectLength": {
      "type": "int",
      "value": "[length(parameters('objectToTest'))]"
    }
  }
}

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
arrayLength	Int	3
stringLength	Int	13
objectLength	Int	4

newGuid

newGuid()

Globálisan egyedi azonosító formátumú értéket ad vissza. Ez a függvény csak egy paraméter alapértelmezett értékében használható.

A Bicepben használja a newGuid függvényt .

Megjegyzések

Ezt a függvényt csak egy paraméter alapértelmezett értékének kifejezésén belül használhatja. Ha ezt a függvényt bárhol máshol használja egy sablonban, hibát ad vissza. A függvény nem engedélyezett a sablon más részeiben, mert minden híváskor más értéket ad vissza. Ha ugyanazt a sablont ugyanazokkal a paraméterekkel helyezi üzembe, az nem eredményezne megbízhatóan ugyanazokat az eredményeket.

A newGuid függvény eltér a guid függvénytől, mert nem vesz fel paramétereket. Ha ugyanazzal a paraméterrel hívja meg a GUID azonosítót, az minden alkalommal ugyanazt az azonosítót adja vissza. Akkor használja a GUID-t, ha megbízhatóan kell létrehoznia ugyanazt a GUID-t egy adott környezethez. Használja a newGuid-t, ha minden alkalommal más azonosítóra van szüksége, például erőforrásokat helyez üzembe egy tesztkörnyezetben.

A newGuid függvény a .NET-keretrendszer Guid struktúráját használja a globálisan egyedi azonosító létrehozásához.

Ha egy korábbi sikeres üzembe helyezés ismételt üzembe helyezésének lehetőségét használja, és a korábbi üzembe helyezés tartalmaz egy újGuid-t használó paramétert, a paraméter nem lesz újraértékelve. Ehelyett a rendszer automatikusan újra felhasználja a korábbi üzembe helyezés paraméterértékét a visszaállítási üzembe helyezés során.

Tesztkörnyezetben előfordulhat, hogy ismétlődően kell üzembe helyeznie azokat az erőforrásokat, amelyek csak rövid ideig élnek. Az egyedi nevek létrehozása helyett a newGuid és az uniqueString használatával egyedi neveket hozhat létre.

Ügyeljen arra, hogy újra üzembe helyezzen egy sablont, amely az újGuid függvényre támaszkodik egy alapértelmezett értékhez. Amikor újra üzembe helyezi a paramétert, és nem ad meg értéket, a függvény újraértékelódik. Ha egy meglévő erőforrást szeretne frissíteni ahelyett, hogy újat hozna létre, adja meg a paraméter értékét a korábbi üzembe helyezésből.

Visszaadott érték

Globálisan egyedi azonosító formátumban 36 karaktert tartalmazó sztring.

Példák

Az alábbi példa egy új azonosítóval rendelkező paramétert mutat be.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "guidValue": {
      "type": "string",
      "defaultValue": "[newGuid()]"
    }
  },
  "resources": [
  ],
  "outputs": {
    "guidOutput": {
      "type": "string",
      "value": "[parameters('guidValue')]"
    }
  }
}

Az előző példában szereplő kimenet minden üzemelő példány esetében eltérő, de a következőhöz hasonló lesz:

Név	Típus	Érték
guidOutput	húr	b76a51fc-bd72-4a77-b9a2-3c29e7d2e551

Az alábbi példa a newGuid függvényt használja egy tárfiók egyedi nevének létrehozásához. Ez a sablon olyan tesztkörnyezetekben használható, ahol a tárfiók rövid ideig létezik, és nem kerül újra üzembe.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "guidValue": {
      "type": "string",
      "defaultValue": "[newGuid()]"
    }
  },
  "variables": {
    "storageName": "[concat('storage', uniqueString(parameters('guidValue')))]"
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2021-04-01",
      "name": "[variables('storageName')]",
      "location": "West US",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "StorageV2",
      "properties": {}
    }
  ],
  "outputs": {
    "nameOutput": {
      "type": "string",
      "value": "[variables('storageName')]"
    }
  }
}

Az előző példában szereplő kimenet minden üzemelő példány esetében eltérő, de a következőhöz hasonló lesz:

Név	Típus	Érték
nameOutput	húr	storagenziwvyru7uxie

padLeft

padLeft(valueToPad, totalLength, paddingCharacter)

Egy jobbra igazított sztringet ad vissza úgy, hogy karaktereket ad hozzá balra, amíg el nem éri a megadott teljes hosszt.

A Bicepben használja a padLeft függvényt .

Paraméterek

Paraméter	Szükséges	Típus	Leírás
valueToPad	Igen	sztring vagy int	A jobbra igazított érték.
totalLength	Igen	egész	A visszaadott sztringben szereplő karakterek teljes száma.
paddingCharacter	Nem	egyetlen karakter	A bal oldali kitöltéshez használandó karakter, amíg el nem éri a teljes hosszt. Az alapértelmezett érték egy szóköz.

Ha az eredeti sztring hosszabb, mint a beszúrandó karakterek száma, a rendszer nem ad hozzá karaktereket.

Visszaadott érték

Legalább a megadott karakterszámmal rendelkező sztring.

Példák

Az alábbi példa bemutatja, hogyan lehet a felhasználó által megadott paraméter értékét a nulla karakter hozzáadásával beszedni, amíg el nem éri a karakterek teljes számát.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "testString": {
      "type": "string",
      "defaultValue": "123"
    }
  },
  "resources": [],
  "outputs": {
    "stringOutput": {
      "type": "string",
      "value": "[padLeft(parameters('testString'),10,'0')]"
    }
  }
}

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
stringOutput	Sztring	0000000123

Helyettesít

replace(originalString, oldString, newString)

Egy új sztringet ad vissza, amely az egyik sztring összes példányát lecseréli egy másik sztringre.

A Bicepben használja a cserefüggvényt.

Paraméterek

Paraméter	Szükséges	Típus	Leírás
originalString	Igen	húr	Az az érték, amely egy sztring összes példányát lecseréli egy másik sztringre.
oldString	Igen	húr	Az eredeti sztringből eltávolítandó sztring.
newString	Igen	húr	Az eltávolított sztring helyett hozzáadni kívánt sztring.

Visszaadott érték

Sztring a lecserélt karakterekkel.

Példák

Az alábbi példa bemutatja, hogyan távolíthatja el az összes kötőjelet a felhasználó által megadott sztringből, és hogyan cserélheti le a sztring egy részét egy másik sztringre.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "testString": {
      "type": "string",
      "defaultValue": "123-123-1234"
    }
  },
  "resources": [],
  "outputs": {
    "firstOutput": {
      "type": "string",
      "value": "[replace(parameters('testString'),'-', '')]"
    },
    "secondOutput": {
      "type": "string",
      "value": "[replace(parameters('testString'),'1234', 'xxxx')]"
    }
  }
}

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
firstOutput	Sztring	1231231234
secondOutput	Sztring	123-123-xxxx

Kihagyás

skip(originalValue, numberToSkip)

A megadott számú karakter után az összes karaktert tartalmazó sztringet, vagy egy tömböt ad vissza, amely a megadott számú elem után az összes elemet tartalmazza.

A Bicepben használja a kihagyó függvényt.

Paraméterek

Paraméter	Szükséges	Típus	Leírás
originalValue	Igen	tömb vagy sztring	A kihagyáshoz használandó tömb vagy sztring.
numberToSkip	Igen	egész	Az kihagyandó elemek vagy karakterek száma. Ha ez az érték 0 vagy kevesebb, a rendszer az érték összes elemét vagy karakterét visszaadja. Ha nagyobb, mint a tömb vagy a sztring hossza, a függvény üres tömböt vagy sztringet ad vissza.

Visszaadott érték

Tömb vagy sztring.

Példák

Az alábbi példa kihagyja a tömb megadott számú elemét és a sztringben megadott számú karaktert.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "testArray": {
      "type": "array",
      "defaultValue": [
        "one",
        "two",
        "three"
      ]
    },
    "elementsToSkip": {
      "type": "int",
      "defaultValue": 2
    },
    "testString": {
      "type": "string",
      "defaultValue": "one two three"
    },
    "charactersToSkip": {
      "type": "int",
      "defaultValue": 4
    }
  },
  "resources": [],
  "outputs": {
    "arrayOutput": {
      "type": "array",
      "value": "[skip(parameters('testArray'),parameters('elementsToSkip'))]"
    },
    "stringOutput": {
      "type": "string",
      "value": "[skip(parameters('testString'),parameters('charactersToSkip'))]"
    }
  }
}

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
arrayOutput	Tömb	["három"]
stringOutput	Sztring	két három

hasít

split(inputString, delimiter)

A megadott elválasztójelekkel tagolt bemeneti sztring részsztringeit tartalmazó karakterlánctömböt ad vissza.

A Bicepben használja az osztott függvényt.

Paraméterek

Paraméter	Szükséges	Típus	Leírás
inputString	Igen	húr	A felosztandó sztring.
Határoló	Igen	sztring vagy sztringtömb	A sztring felosztásához használandó elválasztó.

Visszaadott érték

Sztringek tömbje.

Példák

Az alábbi példa vesszővel és pontosvesszővel osztja fel a bemeneti sztringet.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "firstString": {
      "type": "string",
      "defaultValue": "one,two,three"
    },
    "secondString": {
      "type": "string",
      "defaultValue": "one;two,three"
    }
  },
  "variables": {
    "delimiters": [ ",", ";" ]
  },
  "resources": [],
  "outputs": {
    "firstOutput": {
      "type": "array",
      "value": "[split(parameters('firstString'),',')]"
    },
    "secondOutput": {
      "type": "array",
      "value": "[split(parameters('secondString'),variables('delimiters'))]"
    }
  }
}

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
firstOutput	Tömb	["one", "two", "three"]
secondOutput	Tömb	["one", "two", "three"]

startsWith

startsWith(stringToSearch, stringToFind)

Meghatározza, hogy egy sztring egy értékkel kezdődik-e. Az összehasonlítás kis- és nagybetűket nem érzékelyítő.

A Bicepben használja a startsWith függvényt .

Paraméterek

Paraméter	Szükséges	Típus	Leírás
stringToSearch	Igen	húr	A keresendő elemet tartalmazó érték.
stringToFind	Igen	húr	A keresendő érték.

Visszaadott érték

Igaz , ha a sztring első karaktere vagy karaktere megegyezik az értékkel, ellenkező esetben Hamis.

Példák

Az alábbi példa a függvények és endsWith a startsWith függvények használatát mutatja be:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [],
  "outputs": {
    "startsTrue": {
      "type": "bool",
      "value": "[startsWith('abcdef', 'ab')]"
    },
    "startsCapTrue": {
      "type": "bool",
      "value": "[startsWith('abcdef', 'A')]"
    },
    "startsFalse": {
      "type": "bool",
      "value": "[startsWith('abcdef', 'e')]"
    },
    "endsTrue": {
      "type": "bool",
      "value": "[endsWith('abcdef', 'ef')]"
    },
    "endsCapTrue": {
      "type": "bool",
      "value": "[endsWith('abcdef', 'F')]"
    },
    "endsFalse": {
      "type": "bool",
      "value": "[endsWith('abcdef', 'e')]"
    }
  }
}

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
startsTrue	Bool	Igaz
startsCapTrue	Bool	Igaz
startsFalse	Bool	Hamis
endsTrue	Bool	Igaz
endsCapTrue	Bool	Igaz
endsFalse	Bool	Hamis

húr

string(valueToConvert)

A megadott értéket sztringgé alakítja.

A Bicepben használja a sztringfüggvényt.

Paraméterek

Paraméter	Szükséges	Típus	Leírás
valueToConvert	Igen	Bármely	A sztringgé konvertálandó érték. Bármilyen típusú érték konvertálható, beleértve az objektumokat és a tömböket is.

Visszaadott érték

A konvertált érték sztringje.

Példák

Az alábbi példa bemutatja, hogyan konvertálhat különböző típusú értékeket sztringekké.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "testObject": {
      "type": "object",
      "defaultValue": {
        "valueA": 10,
        "valueB": "Example Text"
      }
    },
    "testArray": {
      "type": "array",
      "defaultValue": [
        "a",
        "b",
        "c"
      ]
    },
    "testInt": {
      "type": "int",
      "defaultValue": 5
    }
  },
  "resources": [],
  "outputs": {
    "objectOutput": {
      "type": "string",
      "value": "[string(parameters('testObject'))]"
    },
    "arrayOutput": {
      "type": "string",
      "value": "[string(parameters('testArray'))]"
    },
    "intOutput": {
      "type": "string",
      "value": "[string(parameters('testInt'))]"
    }
  }
}

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
objectOutput	Sztring	{"valueA":10;"valueB":"Example Text"}
arrayOutput	Sztring	["a","b";"c"]
intOutput	Sztring	5

Substring

substring(stringToParse, startIndex, length)

Egy alsztringet ad vissza, amely a megadott karakterhelyzetben kezdődik, és a megadott számú karaktert tartalmazza.

A Bicepben használja az összevonási függvényt .

Paraméterek

Paraméter	Szükséges	Típus	Leírás
stringToParse	Igen	húr	Az eredeti sztring, amelyből az alsztring ki lesz nyerve.
startIndex	Nem	egész	Az alsztring nulla alapú kezdő karakterpozíciója.
length (hossz)	Nem	egész	Az alsztring karaktereinek száma. A sztringen belüli helyre kell hivatkoznia. Nullának vagy nagyobbnak kell lennie. Ha nincs megadva, a rendszer a sztring fennmaradó részét adja vissza a kezdő pozícióból.

Visszaadott érték

Az alászúrás. Vagy üres sztring, ha a hossz nulla.

Megjegyzések

A függvény meghiúsul, ha az alsztring a sztring végén túlnyúlik, vagy ha a hossz kisebb, mint nulla. Az alábbi példa a következő hibaüzenettel meghiúsul: "Az index- és hosszparamétereknek a sztring egy helyére kell hivatkoznia. Az indexparaméter: "0", a hosszparaméter: "11", a sztringparaméter hossza: "10".

"parameters": {
  "inputString": {
    "type": "string",
    "value": "1234567890"
  }
}, "variables": {
  "prefix": "[substring(parameters('inputString'), 0, 11)]"
}

Példák

Az alábbi példa egy paraméterből nyer ki egy részszúrást.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "testString": {
      "type": "string",
      "defaultValue": "one two three"
    }
  },
  "resources": [],
  "outputs": {
    "substringOutput": {
      "type": "string",
      "value": "[substring(parameters('testString'), 4, 3)]"
    }
  }
}

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
substringOutput	Sztring	kettő

Elvétel

take(originalValue, numberToTake)

Tömböt vagy sztringet ad vissza. A tömbök a tömb kezdetétől megadott számú elemet tartalmaznak. A sztringek a sztring elejétől megadott számú karaktert tartalmaznak.

A Bicepben használja a take függvényt.

Paraméterek

Paraméter	Szükséges	Típus	Leírás
originalValue	Igen	tömb vagy sztring	Az elemeket átvenni kívánt tömb vagy sztring.
numberToTake	Igen	egész	A felvenni kívánt elemek vagy karakterek száma. Ha ez az érték 0 vagy kevesebb, a függvény egy üres tömböt vagy sztringet ad vissza. Ha nagyobb, mint az adott tömb vagy sztring hossza, a rendszer visszaadja a tömb vagy sztring összes elemét.

Visszaadott érték

Tömb vagy sztring.

Példák

Az alábbi példa a tömb megadott számú elemét és egy sztringből származó karaktereket veszi fel.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "testArray": {
      "type": "array",
      "defaultValue": [
        "one",
        "two",
        "three"
      ]
    },
    "elementsToTake": {
      "type": "int",
      "defaultValue": 2
    },
    "testString": {
      "type": "string",
      "defaultValue": "one two three"
    },
    "charactersToTake": {
      "type": "int",
      "defaultValue": 2
    }
  },
  "resources": [],
  "outputs": {
    "arrayOutput": {
      "type": "array",
      "value": "[take(parameters('testArray'),parameters('elementsToTake'))]"
    },
    "stringOutput": {
      "type": "string",
      "value": "[take(parameters('testString'),parameters('charactersToTake'))]"
    }
  }
}

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
arrayOutput	Tömb	["egy", "kettő"]
stringOutput	Sztring	ekkor

toLower

toLower(stringToChange)

A megadott sztringet kisbetűssé alakítja.

A Bicepben használja a toLower függvényt .

Paraméterek

Paraméter	Szükséges	Típus	Leírás
stringToChange	Igen	húr	A kisbetűssé konvertálandó érték.

Visszaadott érték

A kisbetűssé konvertált sztring.

Példák

Az alábbi példa egy paraméter értékét kisbetűssé és nagybetűssé alakítja.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "testString": {
      "type": "string",
      "defaultValue": "One Two Three"
    }
  },
  "resources": [],
  "outputs": {
    "toLowerOutput": {
      "type": "string",
      "value": "[toLower(parameters('testString'))]"
    },
    "toUpperOutput": {
      "type": "string",
      "value": "[toUpper(parameters('testString'))]"
    }
  }
}

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
toLowerOutput	Sztring	egy két há'
toUpperOutput	Sztring	EGY KÉT THR Enterprise kiadás

toUpper

toUpper(stringToChange)

A megadott sztringet nagybetűssé alakítja.

A Bicepben használja a toUpper függvényt.

Paraméterek

Paraméter	Szükséges	Típus	Leírás
stringToChange	Igen	húr	A nagybetűssé konvertálandó érték.

Visszaadott érték

A nagybetűssé konvertált sztring.

Példák

Az alábbi példa egy paraméter értékét kisbetűssé és nagybetűssé alakítja.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "testString": {
      "type": "string",
      "defaultValue": "One Two Three"
    }
  },
  "resources": [],
  "outputs": {
    "toLowerOutput": {
      "type": "string",
      "value": "[toLower(parameters('testString'))]"
    },
    "toUpperOutput": {
      "type": "string",
      "value": "[toUpper(parameters('testString'))]"
    }
  }
}

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
toLowerOutput	Sztring	egy két há'
toUpperOutput	Sztring	EGY KÉT THR Enterprise kiadás

Berendezés

trim(stringToTrim)

Eltávolítja az összes kezdő és záró szóköz karaktert a megadott sztringből.

A Bicepben használja a vágási függvényt.

Paraméterek

Paraméter	Szükséges	Típus	Leírás
stringToTrim	Igen	húr	A levágandó érték.

Visszaadott érték

A sztring bevezető és záró szóköz karakterek nélkül.

Példák

Az alábbi példa levágja a szóköz karaktereket a paraméterből.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "testString": {
      "type": "string",
      "defaultValue": "    one two three   "
    }
  },
  "resources": [],
  "outputs": {
    "return": {
      "type": "string",
      "value": "[trim(parameters('testString'))]"
    }
  }
}

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
vissza	Sztring	egy két há'

uniqueString

uniqueString(baseString, ...)

A paraméterekként megadott értékek alapján létrehoz egy determinisztikus kivonatsztringet.

A Bicepben használja az uniqueString függvényt .

Paraméterek

Paraméter	Szükséges	Típus	Leírás
baseString	Igen	húr	A kivonatoló függvényben egy egyedi sztring létrehozásához használt érték.
szükség szerint további paraméterek	Nem	húr	Az egyediséget meghatározó érték létrehozásához szükség szerint annyi sztringet adhat hozzá.

Megjegyzések

Ez a függvény akkor hasznos, ha egyedi nevet kell létrehoznia egy erőforráshoz. Olyan paraméterértékeket ad meg, amelyek korlátozzák az eredmény egyediségének hatókörét. Megadhatja, hogy a név egyedi legyen-e előfizetésre, erőforráscsoportra vagy üzembe helyezésre.

A visszaadott érték nem véletlenszerű sztring, hanem kivonatfüggvény eredménye. A visszaadott érték 13 karakter hosszú. Ez nem globálisan egyedi. Érdemes lehet kombinálni az értéket az elnevezési konvencióból származó előtaggal, hogy értelmes nevet hozzon létre. Az alábbi példa a visszaadott érték formátumát mutatja be. A tényleges érték a megadott paraméterektől függ.

tcvhiyu5h2o5o

Az alábbi példák bemutatják, hogyan hozhat uniqueString létre egyedi értéket a gyakran használt szintekhez.

Előfizetésre vonatkozó egyedi hatókör

"[uniqueString(subscription().subscriptionId)]"

Erőforráscsoportra vonatkozó egyedi hatókör

"[uniqueString(resourceGroup().id)]"

Erőforráscsoport üzembe helyezésének egyedi hatóköre

"[uniqueString(resourceGroup().id, deployment().name)]"

Az alábbi példa bemutatja, hogyan hozhat létre egyedi nevet egy tárfióknak az erőforráscsoport alapján. Az erőforráscsoporton belül a név nem egyedi, ha ugyanúgy épül fel.

"resources": [{
  "name": "[concat('storage', uniqueString(resourceGroup().id))]",
  "type": "Microsoft.Storage/storageAccounts",
  ...

Ha minden sablon üzembe helyezésekor létre kell hoznia egy új egyedi nevet, és nem kívánja frissíteni az erőforrást, használhatja az utcNow függvényt a következőveluniqueString: . Ezt a megközelítést tesztkörnyezetben is használhatja. Példa: utcNow.

Visszaadott érték

Egy 13 karakterből álló sztring.

Példák

Az alábbi példa a következő eredményből ad uniquestringvissza eredményeket:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [],
  "outputs": {
    "uniqueRG": {
      "type": "string",
      "value": "[uniqueString(resourceGroup().id)]"
    },
    "uniqueDeploy": {
      "type": "string",
      "value": "[uniqueString(resourceGroup().id, deployment().name)]"
    }
  }
}

Uri

uri(baseUri, relativeUri)

Abszolút URI-t hoz létre a baseUri és a relativeUri sztring kombinálásával.

A Bicepben használja az uri függvényt.

Paraméterek

Paraméter	Szükséges	Típus	Leírás
baseUri	Igen	húr	Az alap uri sztring. Ügyeljen arra, hogy megfigyelje a záró perjel (`/`) kezelésével kapcsolatos viselkedést az alábbi táblázat szerint.
relativeUri	Igen	húr	Az alap URI-sztringhez hozzáadandó relatív URI-sztring.

Ha a baseUri záró perjelben végződik, az eredmény a baseUri és a relativeUri lesz.
Ha a baseUri nem végződik záró perjellel, két dolog egyike történik.
- Ha a baseUri-nak egyáltalán nincs perjele (az // elöl lévőtől eltekintve), akkor az eredmény a baseUri és a relativeUri lesz.
- Ha a baseUri-nak vannak perjelei, de nem végződik perjellel, az utolsó perjeltől kezdve minden el lesz távolítva a baseUri-ból, és az eredmény a baseUri és a relativeUri lesz.

Íme néhány példa:

uri('http://contoso.org/firstpath', 'myscript.sh') -> http://contoso.org/myscript.sh
uri('http://contoso.org/firstpath/', 'myscript.sh') -> http://contoso.org/firstpath/myscript.sh
uri('http://contoso.org/firstpath/azuredeploy.json', 'myscript.sh') -> http://contoso.org/firstpath/myscript.sh
uri('http://contoso.org/firstpath/azuredeploy.json/', 'myscript.sh') -> http://contoso.org/firstpath/azuredeploy.json/myscript.sh

A részletekért a baseUri és a relativeUri paraméterek az RFC 3986 5. szakaszában meghatározottak szerint lesznek feloldva.

Visszaadott érték

Az alap- és relatív értékek abszolút URI-jának sztringje.

Példák

Az alábbi példa bemutatja, hogyan hozhat létre beágyazott sablonra mutató hivatkozást a szülősablon értéke alapján.

"templateLink": "[uri(deployment().properties.templateLink.uri, 'nested/azuredeploy.json')]"

Az alábbi példasablon bemutatja, hogyan használható uri, uriComponentés uriComponentToStringhogyan.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "variables": {
    "uriFormat": "[uri('http://contoso.com/resources/', 'nested/azuredeploy.json')]",
    "uriEncoded": "[uriComponent(variables('uriFormat'))]"
  },
  "resources": [
  ],
  "outputs": {
    "uriOutput": {
      "type": "string",
      "value": "[variables('uriFormat')]"
    },
    "componentOutput": {
      "type": "string",
      "value": "[variables('uriEncoded')]"
    },
    "toStringOutput": {
      "type": "string",
      "value": "[uriComponentToString(variables('uriEncoded'))]"
    }
  }
}

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
uriOutput	Sztring	`http://contoso.com/resources/nested/azuredeploy.json`
componentOutput	Sztring	`http%3A%2F%2Fcontoso.com%2Fresources%2Fnested%2Fazuredeploy.json`
toStringOutput	Sztring	`http://contoso.com/resources/nested/azuredeploy.json`

uriComponent

uricomponent(stringToEncode)

Kódolja az URI-t.

A Bicepben használja az uriComponent függvényt .

Paraméterek

Paraméter	Szükséges	Típus	Leírás
stringToEncode	Igen	húr	A kódolandó érték.

Visszaadott érték

Az URI kódolt értékének sztringje.

Példák

Az alábbi példasablon bemutatja, hogyan használható uri, uriComponentés uriComponentToStringhogyan.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "variables": {
    "uriFormat": "[uri('http://contoso.com/resources/', 'nested/azuredeploy.json')]",
    "uriEncoded": "[uriComponent(variables('uriFormat'))]"
  },
  "resources": [
  ],
  "outputs": {
    "uriOutput": {
      "type": "string",
      "value": "[variables('uriFormat')]"
    },
    "componentOutput": {
      "type": "string",
      "value": "[variables('uriEncoded')]"
    },
    "toStringOutput": {
      "type": "string",
      "value": "[uriComponentToString(variables('uriEncoded'))]"
    }
  }
}

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
uriOutput	Sztring	`http://contoso.com/resources/nested/azuredeploy.json`
componentOutput	Sztring	`http%3A%2F%2Fcontoso.com%2Fresources%2Fnested%2Fazuredeploy.json`
toStringOutput	Sztring	`http://contoso.com/resources/nested/azuredeploy.json`

uriComponentToString

uriComponentToString(uriEncodedString)

Egy URI kódolt érték sztringét adja vissza.

A Bicepben használja az uriComponentToString függvényt.

Paraméterek

Paraméter	Szükséges	Típus	Leírás
uriEncodedString	Igen	húr	Az URI kódolt értéke, amely sztringgé konvertálható.

Visszaadott érték

URI kódolt érték dekódolt sztringje.

Példák

Az alábbi példa bemutatja, hogyan használható uri, uriComponentés uriComponentToStringhogyan.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "variables": {
    "uriFormat": "[uri('http://contoso.com/resources/', 'nested/azuredeploy.json')]",
    "uriEncoded": "[uriComponent(variables('uriFormat'))]"
  },
  "resources": [
  ],
  "outputs": {
    "uriOutput": {
      "type": "string",
      "value": "[variables('uriFormat')]"
    },
    "componentOutput": {
      "type": "string",
      "value": "[variables('uriEncoded')]"
    },
    "toStringOutput": {
      "type": "string",
      "value": "[uriComponentToString(variables('uriEncoded'))]"
    }
  }
}

Az előző példában szereplő kimenet az alapértelmezett értékekkel a következő:

Név	Típus	Érték
uriOutput	Sztring	`http://contoso.com/resources/nested/azuredeploy.json`
componentOutput	Sztring	`http%3A%2F%2Fcontoso.com%2Fresources%2Fnested%2Fazuredeploy.json`
toStringOutput	Sztring	`http://contoso.com/resources/nested/azuredeploy.json`

Következő lépések

Az ARM-sablonok szakaszainak leírását az ARM-sablonok szerkezetének és szintaxisának ismertetése című témakörben találja.
Ha több sablont szeretne egyesíteni, olvassa el a Csatolt és beágyazott sablonok használata Azure-erőforrások üzembe helyezésekor című témakört.
Ha adott számú alkalommal szeretne iterálni egy erőforrástípus létrehozásakor, tekintse meg az erőforrás-iterációt ARM-sablonokban.
A létrehozott sablon üzembe helyezéséről az Erőforrások üzembe helyezése ARM-sablonokkal és az Azure PowerShell-lel című témakörben olvashat.

Share via

Sztringfüggvények ARM-sablonokhoz

base64

Paraméterek

Visszaadott érték

Példák

base64ToJson

Paraméterek

Visszaadott érték

Példák

base64ToString

Paraméterek

Visszaadott érték

Példák

összefűzés

Paraméterek

Visszaadott érték

Példák

contains

Paraméterek

Visszaadott érték

Példák

dataUri

Paraméterek

Visszaadott érték

Példák

dataUriToString

Paraméterek

Visszaadott érték

Példák

üres

Paraméterek

Visszaadott érték

Példák

endsWith

Paraméterek

Visszaadott érték

Példák

első

Paraméterek

Visszaadott érték

Példák

format

Paraméterek

Megjegyzések

Példák

guid

Paraméterek

Megjegyzések

Visszaadott érték

Példák

indexOf

Paraméterek

Visszaadott érték

Példák

Csatlakozás

Paraméterek

Visszaadott érték

Példák

json

utolsó

Paraméterek

Visszaadott érték

Példák

lastIndexOf

Paraméterek

Visszaadott érték

Példák

length (hossz)

Paraméterek

Visszaadott érték

Példák

newGuid

Megjegyzések

Visszaadott érték

Példák

padLeft

Paraméterek

Visszaadott érték

Példák