Add docs for IL3001

Author: agocke

docs/code-quality/code-analysis-warnings-for-managed-code-by-checkid.md

@@ -288,6 +288,7 @@ f1_keywords:
 - CA5122
 - CA5374
 - IL3000
+- IL3001
 ms.assetid: 5cb221f6-dc59-4abf-9bfa-adbd6f907f96
 author: mikejo5000
 ms.author: mikejo
@@ -600,4 +601,5 @@ The following table lists Code Analysis warnings for managed code by the CheckId
 | CA5400 | [CA5400 Ensure HttpClient certificate revocation list check is not disabled](../code-quality/ca5400.md) | A revoked certificate isn't trusted anymore. It could be used by attackers passing some malicious data or stealing sensitive data in HTTPS communication. |
 | CA5401 | [CA5401 Do not use CreateEncryptor with non-default IV](../code-quality/ca5401.md) | Symmetric encryption should always use a non-repeatable initialization vector to prevent dictionary attacks. |
 | CA5402 | [CA5402 Use CreateEncryptor with the default IV](../code-quality/ca5402.md) | Symmetric encryption should always use a non-repeatable initialization vector to prevent dictionary attacks. |
-| IL3000 | [IL3000 Avoid using accessing Assembly file path when publishing as a single-file](../code-quality/il3000.md) | Avoid using accessing Assembly file path when publishing as a single-file |
+| IL3000 | [IL3000 Avoid accessing Assembly file path when publishing as a single-file](../code-quality/il3000.md) | Avoid using accessing Assembly file path when publishing as a single-file |
+| IL3001 | [IL3000 Avoid accessing Assembly file path when publishing as a single-file](../code-quality/il3000.md) | Avoid accessing Assembly file path when publishing as a single-file |

docs/code-quality/il3000.md

@@ -1,5 +1,5 @@
 ---
-title: "IL3000: Avoid using accessing Assembly file path when publishing as a single-file"
+title: "IL3000: Avoid accessing Assembly file path when publishing as a single-file"
 description: "Assembly.Location always returns an empty string for assemblies embedded in a single-file bundle"
 ms.date: 08/04/2020
 ms.topic: reference
@@ -12,7 +12,7 @@ f1_keywords:
   - "IL3000"
   - "AvoidAssemblyLocationInSingleFile"
 ---
-# IL3000: Avoid using accessing Assembly file path when publishing as a single-file
+# IL3000: Avoid accessing Assembly file path when publishing as a single-file
 
 ## Cause
 

docs/code-quality/il3001.md

@@ -0,0 +1,28 @@
+---
+title: "IL3001: Avoid accessing Assembly file path when publishing as a single-file"
+description: "Assembly.GetFile(s) will throw for assemblies embedded in a single-file app"
+ms.date: 08/18/2020
+ms.topic: reference
+author: agocke
+ms.author: angocke
+manager: angocke
+ms.workload:
+  - "multiple"
+f1_keywords:
+  - "IL3001"
+  - "AvoidAssemblyLocationInSingleFile"
+---
+# IL3001: Avoid accessing Assembly file path when publishing as a single-file
+
+## Cause
+
+When publishing as a single-file (for example, by setting the PublishSingleFile property in a project to true), calling the `Assembly.GetFile(s)` methods for
+assemblies embedded inside the single-file bundle always throws an exception.
+
+## How to fix violations
+
+To embed files in assemblies in single-file bundles, consider using embedded resources and the `Assembly.GetManifestResourceStream` method.
+
+## When to suppress warnings
+
+It's appropriate to silence this warning if the assembly being accessed is definitely not in the single-file bundle. This may be the case if the assembly is being loaded dynamically from a file path.

docs/code-quality/toc.yml

@@ -989,5 +989,7 @@
         items:
         - name: Overview
           displayName: "publish warnings"
-        - name: "IL3000: Avoid using accessing Assembly file path when publishing as a single-file"
+        - name: "IL3000: Avoid accessing Assembly file path when publishing as a single-file"
           href: il3000.md
+        - name: "IL3001: Avoid accessing Assembly file path when publishing as a single-file"
+          href: il3001.md